使用IRONWORD

.NET Word API（开发人员使用方法）

发布 2024年四月3日

介绍

"(《世界人权宣言》).NET Word API该工具为开发人员提供了强大的工具，可在其应用程序中转换 Word 文档、与 MS Word 文档交互并对其进行操作。该 API 旨在简化 Microsoft Word 文档的处理流程，使以编程方式创建、编辑、转换和管理文档变得更加容易。在本文中，我们将探讨铁字以了解其操作 Word 文档的能力。

IronWord 简介

铁字是 .NET Word API 生态系统中的一个 .NET Word 库，专为在其 .NET 应用程序中处理 Microsoft Word 文档的开发人员设计。有了 IronWord，开发人员无需在服务器或客户端机器上安装 Microsoft Word，即可轻松读取、编写和修改 Word 文档。对于需要自动执行文档处理任务的应用程序，例如通过邮件合并功能生成报告、发票或个性化信函，这种能力尤其有益。

IronWord 的功能

IronWord 提供全面的功能，可满足 Word 文档操作的各个方面。让我们来探讨每一组功能，重点是它们如何实现多个文档的操作和合并，这些功能归类于 "文档结构 "和 "文档元素"。

文档结构

阅读和编辑 Word：使用 IronWord，您可以从 Word 文档中提取特定信息，例如提取文本进行编辑或重新利用，以及检索可能需要在其他地方使用的图片。这种能力对于旨在合并 Word 文档和处理现有 DOCX 文件中包含的信息的应用程序至关重要。

多种格式：IronWord 支持多种文件格式，增强了其在 .NET 应用程序中转换 Word 文档的实用性。

编辑页面设置：使用 IronWord 可以直接定制 Word 文档的物理布局。您可以将各种 MS Word 文件的纸张大小调整为标准或自定义尺寸，改变文档不同部分的方向，设置页边距以确保正确对齐，甚至还可以修改背景颜色以达到美观或突出显示部分的目的。

添加段落：IronWord 可以添加和删除text runs within paragraphs此外，翻译人员还必须使用.NET、Java、Python 或 Node js，这对于编辑和格式化大段文本至关重要。此外，您还可以通过在文本中直接插入图片和形状、调整样式以符合设计规范以及设置对齐方式来美化段落。添加子弹和编号列表的功能也有助于更有效地组织内容。

using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Create and add styled text to a paragraph
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
// Add paragraph and export docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Create and add styled text to a paragraph
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
// Add paragraph and export docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
' Create and add styled text to a paragraph
Private paragraph As New Paragraph()
paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
' Add paragraph and export docx
doc.AddParagraph(paragraph)
doc.SaveAs("newdocument.docx")

VB C#

添加表格：表在 IronWord 中，"...... "是 DOCX 文件的重要组成部分，使用 IronWord 可以轻松操作，支持动态文档生成。您可以添加或删除行和列，这一操作对于数据量可能变化的动态文档生成至关重要。合并和拆分单元格为您提供了格式化复杂表格的多功能性，自定义边框和布局尺寸可以让您的表格看起来更精致、更专业。

using IronWord;
using IronWord.Models;
// Create a table cell with a paragraph containing text
TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
// Configure a common border style for the table
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};
// Apply the border style to the cell
cell.Borders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
// Create a table row and add the same cell twice
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);
// Create a table, add the row, then create and export the Word document
Table table = new Table();
table.AddRow(row);
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx");

using IronWord;
using IronWord.Models;
// Create a table cell with a paragraph containing text
TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
// Configure a common border style for the table
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};
// Apply the border style to the cell
cell.Borders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
// Create a table row and add the same cell twice
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);
// Create a table, add the row, then create and export the Word document
Table table = new Table();
table.AddRow(row);
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx");

Imports IronWord
Imports IronWord.Models
' Create a table cell with a paragraph containing text
Private cell As New TableCell(New Paragraph(New TextRun("Sample text")))
' Configure a common border style for the table
Private borderStyle As New BorderStyle With {
	.BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
	.BorderValue = IronWord.Models.Enums.BorderValues.Thick,
	.BorderSize = 5
}
' Apply the border style to the cell
cell.Borders = New TableBorders With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}
' Create a table row and add the same cell twice
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)
' Create a table, add the row, then create and export the Word document
Dim table As New Table()
table.AddRow(row)
Dim doc As New WordDocument(table)
doc.SaveAs("Document.docx")

VB C#

.NET Word API（如何为开发人员工作）：图 1 - 带有表格的输出 PDF

文档元素

添加文本运行：该功能可对文本内容进行细粒度控制。您可以添加、追加和分割文本运行，这对动态文档创建至关重要。样式选项非常广泛，包括更改字体家族、大小和颜色，以及添加粗体、斜体和其他文本装饰。您还可以在文本运行中嵌入图片，创建一个内容丰富、具有视觉吸引力的文档。

添加图片：IronWord 允许全面的图像处理在 Word 文档内。您可以加载各种来源的图片，将文字无缝地包裹在图片周围，并调整图片尺寸以适应您的布局。可以设置位置偏移和与文档角落的距离，这意味着您的图像将始终保持完美的位置。

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
Private image As New IronWord.Models.Image("your-image.jpg") With {
	.Width = 200,
	.Height = 200
}
Private paragraph, add, add, [and] As Create
paragraph.AddImage(image)
doc.AddParagraph(paragraph)
doc.SaveAs("save_document.docx")

VB C#

添加形状：形状可以为文档增添显著的视觉效果，IronWord 为您提供了精确插入和自定义形状的工具。您可以设置形状类型(如矩形、圆形、箭头等。)您还可以确定文字应如何环绕形状，指定精确的尺寸和位置，甚至旋转形状以达到所需的视觉效果。

兼容性

.NET 版本和项目类型

.NET Word API（如何为开发人员工作）：图 2 - IronWord 兼容的 .NET 版本和项目类型

IronWord 的设计在 .NET 生态系统中具有广泛的兼容性，支持各种 .NET 版本的 C#、VB.NET 和 F#，包括 .NET Core、.NET Standard 和 .NET Framework。这样才能确保其在当代和传统应用程序中的实用性。该库的多功能性扩展到项目类型，通过与 Blazor、WebForms、Xamarin、MAUI、WPF 和控制台应用程序的集成，可适应网络、移动和桌面应用程序。