如何在 C# 中将文档导出为 Word

如何在 C# 中将文档导出为 WORD 格式？

1. 创建一个新的 C# Visual Studio 项目。
2. 安装 C# Word 库，以便将数据导出到 Word。
3. 导入 Word 库的依赖项。
4. 使用"new WordDocument(paragraph)"方法创建一个新的 Word 文档。
5. 使用"SaveAs()"函数保存新创建的 Word 文档。

如何创建一个新的 C# 控制台应用程序？

要在 Visual Studio 中创建一个新的 C# 控制台应用程序，请按照以下步骤操作。 "控制台应用程序"模板为学习如何生成 WORD 文档提供了简单的入门起点，便于后续将该功能集成到 Web 服务或桌面软件等大型应用程序中。

1. 打开 Visual Studio。 在启动界面中，选择"创建新项目"。

Visual Studio 启动屏幕显示"创建新项目"按钮高亮显示，用于开始创建一个新的 C# 控制台应用程序。

2. 选择"控制台应用程序"，然后单击"下一步"。 若出现多个选项，请选择 C# 版本。

Visual Studio 中的项目模板选择窗口显示控制台应用程序模板选项，并应用了 C# 语言筛选器。

3. 输入项目名称和位置。 点击"下一步"，选择 .NET 6.0 或更高版本，然后点击"创建"。

什么是 IronWord，我为什么要使用它？

IronWord 是一个 .NET 库，它提供了一个方便的 API，用于在 C# 中处理 Word 文档。 它允许开发人员在 C# 应用程序中创建 WORD 文档、修改现有文档并将其导出。 使用 IronWord，您可以根据来自各种来源（例如数据库、API 或用户输入）的数据动态生成 Word 文档。 该库处理了所有复杂的底层 Office Open XML 规范，让您能够专注于业务逻辑，而非文档格式的繁琐细节。

IronWord 在 WORD 文档处理方面具有多项优势。 与某些需要在服务器或开发机上安装 Microsoft Office 的替代方案不同，IronWord 能够独立运行，因此非常适合云部署、容器化应用程序以及无法安装 Office 的环境。 该库支持多种文档元素，包括段落、表格、图片、页眉、页脚、样式和格式选项，让您能够完全掌控文档的外观和结构。

如何使用 IronWord 将数据导出到 WORD 文档？

让我们通过一个实际示例，了解如何使用 C# 中的 IronWord 将数据导出到 WORD 文档。 请参考以下代码片段，该片段演示了创建简单 WORD 文档的基本流程：

using IronWord;
using IronWord.Models;

System.Console.WriteLine("Enter the Text to export it to word document");
var userInput = System.Console.ReadLine();

// Create textRun which is a part of a paragraph content
Text textRun = new Text(userInput);
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);

// Create a new document object and add the paragraph to it
WordDocument doc = new WordDocument(paragraph);

// Export document to "document.docx" file
doc.SaveAs("document.docx");

using IronWord;
using IronWord.Models;

System.Console.WriteLine("Enter the Text to export it to word document");
var userInput = System.Console.ReadLine();

// Create textRun which is a part of a paragraph content
Text textRun = new Text(userInput);
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);

// Create a new document object and add the paragraph to it
WordDocument doc = new WordDocument(paragraph);

// Export document to "document.docx" file
doc.SaveAs("document.docx");

Imports IronWord
Imports IronWord.Models

System.Console.WriteLine("Enter the Text to export it to word document")
Dim userInput = System.Console.ReadLine()

' Create textRun which is a part of a paragraph content
Dim textRun As New Text(userInput)
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)

' Create a new document object and add the paragraph to it
Dim doc As New WordDocument(paragraph)

' Export document to "document.docx" file
doc.SaveAs("document.docx")

在这个例子中，我们将创建一个简单的 Word 文档，其中包含一个段落，内容为用户提供的文本。 让我们逐步解析代码： 1.导入所需库：我们首先从 IronWord 导入必要的命名空间。 IronWord 命名空间包含主要文档类，而 IronWord.Models 提供内容模型类。 2.创建文本内容：我们创建一个 Text 对象，表示我们要在 Word 文档中包含的文本内容。 在这种情况下，它是从控制台收集到的 userInput。 3.创建段落：接下来，我们创建一个 Paragraph 对象，并将 Text 对象 (textRun) 添加到该对象作为子元素。 WORD 中的段落通常包含一个或多个文本段，允许在单个段落内混合使用不同格式。 4.创建 Word 文档：我们实例化一个新的 WordDocument 对象，并将我们创建的段落作为参数传递。 这将使用指定的内容创建一个新的 Word 文档。 5.导出文档：最后，我们调用 @@--CODE-92592--CODE-92592 对象的 @@--CODE-92593--CODE-92593 的方法，将文档导出为名为"@@--CODE-92593"的 .docx 文件。默认情况下，该文件保存在应用程序的工作目录中。

本示例演示了使用 IronWord 将数据导出到 Word 文档的基本工作流程。 您可以根据具体需求自定义现有 WORD 文档的内容和结构。 例如，您可以添加多个段落、设置文本格式、插入表格、图像、页眉、页脚等等。

如何在 WORD 文档中添加更复杂的内容？

虽然基本示例展示了简单的文本导出，但 IronWord 支持更为复杂的文档创建。 以下示例演示了如何添加包含多个段落和样式的格式化文本：

using IronWord;
using IronWord.Models;

// Create a document with multiple formatted paragraphs
WordDocument doc = new WordDocument();

// Add a title paragraph with bold formatting
Paragraph titleParagraph = new Paragraph();
Text titleText = new Text("Sales Report Q4 2024");
titleText.Style = new TextStyle() { Bold = true, FontSize = 24 };
titleParagraph.AddChild(titleText);
doc.AddChild(titleParagraph);

// Add a regular paragraph with mixed formatting
Paragraph contentParagraph = new Paragraph();
Text normalText = new Text("Total revenue for Q4 was ");
Text emphasizedText = new Text("$1.2 million");
emphasizedText.Style = new TextStyle() { Bold = true, Italic = true };
Text endText = new Text(", exceeding projections by 15%.");

contentParagraph.AddChild(normalText);
contentParagraph.AddChild(emphasizedText);
contentParagraph.AddChild(endText);
doc.AddChild(contentParagraph);

// Save the formatted document
doc.SaveAs("quarterly_report.docx");

using IronWord;
using IronWord.Models;

// Create a document with multiple formatted paragraphs
WordDocument doc = new WordDocument();

// Add a title paragraph with bold formatting
Paragraph titleParagraph = new Paragraph();
Text titleText = new Text("Sales Report Q4 2024");
titleText.Style = new TextStyle() { Bold = true, FontSize = 24 };
titleParagraph.AddChild(titleText);
doc.AddChild(titleParagraph);

// Add a regular paragraph with mixed formatting
Paragraph contentParagraph = new Paragraph();
Text normalText = new Text("Total revenue for Q4 was ");
Text emphasizedText = new Text("$1.2 million");
emphasizedText.Style = new TextStyle() { Bold = true, Italic = true };
Text endText = new Text(", exceeding projections by 15%.");

contentParagraph.AddChild(normalText);
contentParagraph.AddChild(emphasizedText);
contentParagraph.AddChild(endText);
doc.AddChild(contentParagraph);

// Save the formatted document
doc.SaveAs("quarterly_report.docx");

Imports IronWord
Imports IronWord.Models

' Create a document with multiple formatted paragraphs
Dim doc As New WordDocument()

' Add a title paragraph with bold formatting
Dim titleParagraph As New Paragraph()
Dim titleText As New Text("Sales Report Q4 2024")
titleText.Style = New TextStyle() With {.Bold = True, .FontSize = 24}
titleParagraph.AddChild(titleText)
doc.AddChild(titleParagraph)

' Add a regular paragraph with mixed formatting
Dim contentParagraph As New Paragraph()
Dim normalText As New Text("Total revenue for Q4 was ")
Dim emphasizedText As New Text("$1.2 million")
emphasizedText.Style = New TextStyle() With {.Bold = True, .Italic = True}
Dim endText As New Text(", exceeding projections by 15%.")

contentParagraph.AddChild(normalText)
contentParagraph.AddChild(emphasizedText)
contentParagraph.AddChild(endText)
doc.AddChild(contentParagraph)

' Save the formatted document
doc.SaveAs("quarterly_report.docx")

本示例演示了如何创建具有多样化格式的文档，使您导出的文档更显专业且视觉上更具吸引力。 TextStyle 类提供了用于控制字体系列、大小、颜色、粗体、斜体、下划线和其他文本属性的属性。

程序化导出 WORD 文档有哪些常见用例？

了解实际应用场景有助于直观理解 WORD 文档导出功能如何为您的项目带来益处。 以下是几个编程生成文档大显身手的常见场景：

发票和收据生成：从计费系统中自动生成包含页眉、表格和付款条款的Professional发票。

报告自动化：自动生成定期财务摘要、绩效指标或合规文档。

邮件合并操作：通过将数据库记录合并到模板中，创建个性化的合同、信函或证书。

文档生成系统：将源代码注释或数据库架构转换为格式化的技术文档。

表单处理：将网页表单或调查问卷回复转换为格式化的 WORD 文档，供利益相关者审阅。

主要收获是什么？

总而言之，IronWord 为在 C# 中将数据导出到 WORD 文档提供了完整的解决方案。 无论您是生成简单的报告、复杂的文档还是动态内容，IronWord 都能简化这一过程，并使开发人员能够通过编程方式创建高质量的 WORD 文档。 通过利用其功能和特性，您可以简化文档生成工作流，并为用户提供Professional文档。

该库无需依赖 Microsoft Office 安装，加之其完善的 API 和稳定的性能，使其成为小型应用程序和 Enterprise 级文档处理系统的理想选择。 随着您进一步探索 IronWord 的功能，您将发现多种方法来优化文档生成流程，并为用户提供更优质的文档解决方案。

要了解更多自动生成 Microsoft Word 文档的技巧，请访问以下链接。