简介

IronWord 是一款强大的 .NET Word API，旨在无需依赖 Office Interop 的情况下，提供高效的 Word 文档操作功能。本文将详细介绍 IronWord 的特点、功能以及其在不同开发环境中的兼容性。

IronWord 简介

IronWord 专注于简化 Word 文档的操作流程，无论是读取、编辑还是创建文档，它都能提供全面的支持。通过其强大的 API，开发者可以轻松实现复杂的文档处理任务。

IronWord 的特点

IronWord 提供了一系列功能，涵盖了 Word 文档操作的方方面面。以下将从“文档结构”和“文档元素”两个方面详细介绍其功能。

文档结构

读取与编辑 Word 文档

IronWord 支持从 Word 文档中提取特定信息，例如提取文本进行编辑或重新利用，还可以检索文档中的图像。这对于需要合并多个文档或处理现有 DOCX 文件的应用程序尤为重要。

支持多种文件格式

IronWord 支持多种文件格式，极大地提升了其在 .NET 应用程序中的实用性，尤其是在文档格式转换方面。

编辑页面设置

IronWord 提供了强大的页面设置功能，允许开发者自定义文档的物理布局。例如：

• 调整纸张大小（标准或自定义尺寸）。
• 更改文档部分的方向。
• 设置边距以确保内容对齐。
• 修改背景颜色以增强文档的视觉效果。

以下是一个示例代码，展示如何使用 IronWord 创建并编辑文档：

using IronWord.Models;
// 加载 docx
WordDocument doc = new WordDocument();
// 创建并添加样式文本到段落
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("探索文档中的文本样式"));
paragraph.AddTextRun(new TextRun("斜体示例", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("粗体示例", new TextStyle { IsBold = true }));
// 添加段落并导出 docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

文档元素

添加文本运行

IronWord 提供了对文本内容的细粒度控制，支持动态文档的创建。开发者可以：

• 添加、附加或拆分文本运行。
• 自定义字体系列、大小、颜色以及添加粗体、斜体等装饰。
• 在文本运行中嵌入图像，创建丰富的视觉文档。

以下是一个示例代码，展示如何在文档中嵌入图像：

using IronWord.Models;
WordDocument doc = new WordDocument();
Image image = new Image("yourImage.jpg")
{
    Width = 200, // 单位：像素
    Height = 200 // 单位：像素
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

添加形状

IronWord 支持在文档中插入和自定义形状，例如矩形、圆形、箭头等。开发者可以：

• 设置形状类型。
• 定义文本环绕方式。
• 指定形状的尺寸、位置和旋转角度。

兼容性

IronWord 在 .NET 生态系统中具有广泛的兼容性，支持多种开发语言和环境。

支持的 .NET 版本与项目类型

IronWord 兼容 C#、VB.NET 和 F

等语言，并支持多种 .NET 项目类型。

应用程序环境

IronWord 可运行于多种平台，包括：

• Windows
• Linux
• iOS
• Android

此外，它还支持 Docker 容器化部署，以及 Azure 和 AWS 云平台的开发。

操作系统与 IDE

IronWord 支持主流的集成开发环境（IDE），如 Microsoft Visual Studio、ReSharper 和 Rider。同时，它兼容多种操作系统和处理器架构（x64、x86、ARM），确保在不同硬件配置下的高效运行。

许可选项

IronWord 提供多种许可方案，以满足不同规模团队的需求。

精简版许可证

• 适用对象：个人开发者。
• 价格：749 美元。
• 特点：支持一个开发者在一个地点的开发项目。

Plus 许可证

• 适用对象：小型团队。
• 价格：1499 美元。
• 特点：支持最多 3 名开发者，适用于 3 个项目的开发。

专业许可证

• 适用对象：大型团队。
• 价格：2999 美元。
• 特点：支持最多 10 名开发者，包含高级支持功能。

结论

IronWord 是一款功能强大且灵活的 .NET Word API，能够满足从个人开发者到大型团队的各种需求。无论是文档的创建、编辑还是格式转换，IronWord 都能提供高效的解决方案。同时，其广泛的兼容性和灵活的许可选项，使其成为 .NET 开发者处理 Word 文档的理想工具。

原文链接: https://ironsoftware.com/csharp/word/blog/using-ironword/net-word-api/