1. IronWord
  2. 入门

开始使用 IronWord

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord：适用于 .NET 的 Word 文档库

IronWord 是由 Iron Software 开发的 Word 文档库。 IronWord 在提供用于 .NET 应用程序中处理 Word 文档的强大功能方面表现出色。

  • 加载、操作和保存 Word 和 Docx 文档。
  • 页面设置：配置纸张大小、页面方向、边距和背景颜色。
  • TextRun：处理文本内容、样式、分割、追加文本以及添加图片。
  • 文本样式：管理字体、大小、颜色、加粗、斜体、删除线、下划线、上标和下标。
  • 段落：添加文本段、图片、形状，设置样式、对齐方式、项目符号和编号列表。
  • 表格：操作表格结构，包括添加行、获取和设置单元格值、删除行、合并单元格等。
  • 图像：从文件或流中加载图像，设置文本环绕、位置偏移、宽度、高度和其他属性。
  • 形状：设置文本环绕、位置偏移、宽度、高度、形状类型和旋转。

    适用于.NET的 Word 文档 C# 库

    1. 下载用于处理 DOCX 文档的 C# 库
    2. 创建和修改 Word 和 DOCX 文档
    3. 添加段落、章节和表格等文档结构
    4. 添加文本运行、图像和形状等文档元素
    5. 轻松为文档元素设计样式

安装

IronWord 库

安装IronWord既快速又容易，请按照以下步骤安装包：

Install-Package IronWord

或者直接从IronWord NuGet 官方网站.

安装后，您可以在 C# 代码顶部添加 using IronWord; 来开始使用。

应用许可证密钥

接着，通过将许可证密钥分配给 License 类的 LicenseKey 属性，为 IronWord 应用一个有效的许可证或试用密钥。 在导入语句之后、使用任何IronWord方法之前，立即包括以下代码：

:path=/static-assets/word/content-code-examples/get-started/get-started-license.cs
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01";
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01"
VB   C#

代码示例

由IronWord生成的DOCX文件在某些版本的Microsoft Word中打开时可能处于兼容模式，导致某些样式不可用。 要将 Word 文档从兼容模式转换出来：

  1. 选择“文件”>“信息”，然后单击“转换”。

  2. 您将收到一条消息提示，说明您的文档将升级到最新的文件格式。 点击“确定”。

创建 Word 和 Docx 文档

通过使用其构造函数之一实例化 WordDocument 类来创建 Word 文档。 之后，使用 SaveAs 方法导出 Word 文档。

:path=/static-assets/word/content-code-examples/get-started/get-started-1.cs
using IronWord;
using IronWord.Models;

// Create textrun
Text textRun = new Text("Sample text");

Paragraph paragraph = new Paragraph();
paragraph.AddText(textRun);

// Create a new Word document
WordDocument doc = new WordDocument(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Create textrun
Private textRun As New Text("Sample text")

Private paragraph As New Paragraph()
paragraph.AddText(textRun)

' Create a new Word document
Dim doc As New WordDocument(paragraph)

' Export docx
doc.SaveAs("document.docx")
VB   C#

添加图片

图像本身不能添加； 相反，它应该被添加到一个文档结构中，如Paragraph、TableCell或Section。 使用 AddImage 方法添加图像。

:path=/static-assets/word/content-code-examples/get-started/get-started-2.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure image
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 250; // In unit pixel
image.Height = 200; // In unit pixel
Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument("document.docx")

' Configure image
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 250 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
VB   C#

添加表格

添加表格需要更多的工作，因为必须创建表格、行、列和表格单元。 然而，通过这种设置，有很多重要的配置机会。 每个单元格可以有不同的样式。 探索各种边框样式，提供多达24种选择。

:path=/static-assets/word/content-code-examples/get-started/get-started-3.cs
using IronWord;
using IronWord.Models;

// Create table cell
TableCell cell = new TableCell();

Text textRun = new Text();
textRun.Text = "Sample text";

// Add textrun to the cell
cell.AddChild(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configure table border
TableBorders tableBorders = new TableBorders() {
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

cell.Borders = tableBorders;

// Create row and add cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

// Create table and add row
Table table = new Table();
table.AddRow(row);

// Create new Word document from the table
WordDocument doc = new WordDocument(table);

// Export Word document
doc.SaveAs("Document.docx");
Imports IronWord
Imports IronWord.Models

' Create table cell
Private cell As New TableCell()

Private textRun As New Text()
textRun.Text = "Sample text"

' Add textrun to the cell
cell.AddChild(New Paragraph(textRun))

' Configure border style
Dim borderStyle As New BorderStyle()
borderStyle.BorderColor = Color.Black
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick
borderStyle.BorderSize = 5

' Configure table border
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

cell.Borders = tableBorders

' Create row and add cell
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)

' Create table and add row
Dim table As New Table()
table.AddRow(row)

' Create new Word document from the table
Dim doc As New WordDocument(table)

' Export Word document
doc.SaveAs("Document.docx")
VB   C#

许可与支持可用

IronWord 是一个付费库，但也提供免费试用许可证。这里.

有关Iron Software的更多信息，请访问我们的网站：https://ironsoftware.com/ 如需更多支持和查询，请询问我们的团队.

Iron Software的支持

如需一般支持和技术咨询，请通过以下邮箱联系我们：support@ironsoftware.com