跳至页脚内容
使用 IRONWORD

如何在 C# 中创建 Word 文档

Microsoft Word 文件广泛用于文档的创建和编辑,使其成为许多商业应用程序的基本组成部分。 在 C# 开发中,以编程方式生成和操作 MS Word 文档的能力至关重要。 实现这一目标的一个强大工具是 IronWord 库,它提供了一套全面的功能,用于在 C# 中处理 Word 文件。

微软还提供了一个开发者教程,介绍如何使用 Visual C# 实现 Microsoft Word 文档的自动化。 在本文中,我们将探讨如何使用 IronWord(一个功能强大的 C# Word 文档库)在 C# 中创建 Word 文档。

如何在 C# 中创建 Word 文档

  1. 在 Visual Studio 中创建一个 C# 项目
  2. 安装 IronWord 库
  3. 创建一个 WordDocument 对象
  4. 使用 AddText 方法添加内容
  5. 将文本段落添加到 WordDocument 对象中
  6. 使用 SaveAs 方法保存为 DOCX 文件

IronWord库

IronWord 网页

IronWord库是由 Iron Software 开发的强大的 C# DOCX 库。 它提供了一个直观的 API,无需安装 Microsoft Office 或 Word Interop 即可构建、编辑和导出 Word 文档。IronWord 支持各种 .NET 版本和平台,简化了在不同环境下处理 Word 文件的过程。

即使不安装 Word 应用,IronWord 也能正常工作。创建 Word 文档不需要 Microsoft Word Interop。

IronWord 的特点

跨平台支持

IronWord 旨在运行于 C#、F# 和 VB.NET 上,支持 .NET 8、7、6、5、Core、Standard 或 Framework。 它用途广泛,可用于网页、移动、桌面和控制台应用程序。

文档结构操作

IronWord 提供了一套丰富的文档结构操作功能,包括读取和编辑 Word 文件。 开发者可以提取文本和图像,编辑页面设置,设置自定义边距,以及添加段落、文本行、图像、形状和表格。

样式和格式

该库允许开发人员为各种元素设置样式,例如字体系列和大小、颜色、粗体、斜体、删除线、下划线、上标和下标。 此外,它还支持自定义对齐方式、背景颜色和项目符号/编号列表。

跨平台兼容性

IronWord 与包括 Windows、Linux、macOS、iOS 和 Android 在内的各种操作系统兼容,使其成为适用于各种应用的通用解决方案。

设置环境

首先,打开Visual Studio ,您将看到欢迎屏幕。

1. 创建一个新的 .NET Framework 控制台应用程序

点击"创建新项目"。搜索"控制台应用程序 (.NET Framework)",从列表中选择它,然后点击"下一步"。为项目命名,然后点击"创建"。Visual Studio 将使用基本模板创建一个新的 .NET Framework 控制台应用程序,其中包括一个作为入口点的 Main 方法。

配置项目名称和位置

2. 使用 NuGet 包管理器安装 IronWord

在 Visual Studio 中,导航至"工具"菜单,选择"NuGet 程序包管理器",然后选择"管理解决方案的 NuGet 程序包"。在 NuGet 窗口中,转到"浏览"选项卡,在搜索框中键入"IronWord",然后按 Enter 键。 从结果中选择该软件包,确保右侧已选中您的控制台应用程序项目,然后单击"安装"。这将添加在 C# 应用程序中使用 IronWord 所需的引用。 现在您就可以开始使用IronWord创建 Word 文档了。

使用 NuGet 包管理器安装 IronWord

使用软件包管理器控制台:

在Package Manager Console中运行以下命令:

Install-Package IronWord

创建 Word 文档的步骤

IronWord 安装完成后,您可以使用该库创建 Word 文档

  1. 导入 IronWord 命名空间:
using IronWord;
using IronWord.Models;
using IronWord;
using IronWord.Models;
Imports IronWord
Imports IronWord.Models
$vbLabelText   $csharpLabel

这些代码行导入了IronWordIronWord.Models命名空间,允许您在 C# 代码中使用 IronWord 库中的类和功能。

  1. 创建 Word 文档实例:
WordDocument doc = new WordDocument();
WordDocument doc = new WordDocument();
Dim doc As New WordDocument()
$vbLabelText   $csharpLabel

这里创建了WordDocument类的一个新实例。 这是一个空白的 Word 文档,您可以开始向其中添加内容。

  1. 向文档添加内容: 以下示例代码向文档对象添加文本:
doc.AddText("Add text using IronWord");
doc.AddText("Add text using IronWord");
doc.AddText("Add text using IronWord")
$vbLabelText   $csharpLabel

这行代码会向 Word 文档中添加一个段落,内容为"使用 IronWord 添加文本"。 AddText方法是一种将文本内容插入文档的便捷方法。

  1. 保存文档:
doc.SaveAs("output.docx");
doc.SaveAs("output.docx");
doc.SaveAs("output.docx")
$vbLabelText   $csharpLabel

在文档中添加内容后,您可以使用SaveAs方法将 Word 文档保存到文件。在本例中,它会将文档以"output.docx"为文件名保存到项目目录中。

以上步骤将创建一个新的 Word 文档,添加一个包含文本的段落,并以指定的文件名保存该文档。

以下是完整的源代码:

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a new Word document
        WordDocument doc = new WordDocument();

        // Add text to the document
        doc.AddText("Add text using IronWord");

        // Save the document to a file
        doc.SaveAs("output.docx");
    }
}
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a new Word document
        WordDocument doc = new WordDocument();

        // Add text to the document
        doc.AddText("Add text using IronWord");

        // Save the document to a file
        doc.SaveAs("output.docx");
    }
}
Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim doc As New WordDocument()

		' Add text to the document
		doc.AddText("Add text using IronWord")

		' Save the document to a file
		doc.SaveAs("output.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

总的来说,这段代码演示了使用 IronWord 库创建 Word 文档的基本步骤。 你只需实例化一个WordDocument对象,向其中添加内容(在本例中是一个简单的段落),然后将文档保存到文件中即可! 文档创建成功。

这是一个简单的例子,您可以根据应用程序的需求对其进行扩展,使其包含更复杂的文档结构格式和其他内容。

有关如何创建、读取和编辑现有 Word 文档的更多代码示例,请访问此代码示例页面。

输出

程序运行后,将在项目目录中生成一个名为"output.docx"的 Word 文档。 您可以打开此文档查看新增内容。

从之前的代码输出 PDF

结论

在本文中,我们探讨了在 C# 应用程序中创建 Microsoft Word 文件的重要性,并介绍了 IronWord 库,它是处理 Word 文档的强大解决方案。 我们介绍了它的功能、在 Visual Studio 中设置 C# 控制台项目的过程,以及安装和使用 IronWord 创建 Word 文档的步骤。 借助 IronWord,开发人员可以将 Word 文档生成功能无缝集成到他们的 C# 应用程序中,从而增强他们的文档处理能力。

有关 IronWord 及其功能的更多详细信息,请访问其官方文档页面。

IronWord 可免费用于开发用途,并可获得商业用途许可。 不过,它还提供免费试用,让用户在做出决定前测试其商业模式下的全部功能。

常见问题解答

如何在 C# 中生成 Word 文档?

您可以使用 IronWord 库在 C# 中生成 Word 文档。首先在 Visual Studio 中设置一个 C# 项目,通过 NuGet 包管理器安装 IronWord,创建一个 WordDocument 实例,使用像 AddText 这样的方法添加内容,并使用 SaveAs 方法保存文档。

IronWord 库在生成 Word 文档时有哪些好处?

IronWord 提供多种好处,包括跨平台支持、文档结构操作以及样式和格式选项。它允许开发人员在不需要 Microsoft Word 或 Word Interop 的情况下处理 Word 文档。

我可以在 Linux 上使用 IronWord 进行文档操作吗?

是的,IronWord 支持包括 Linux 在内的各种平台,使您可以在不同操作系统中操作 Word 文档,而无需 Microsoft Word。

使用 C# 向 Word 文档添加文本需要哪些步骤?

要使用 IronWord 向 Word 文档添加文本,创建一个 WordDocument 实例,并使用 AddText 方法将文本插入文档。最后,使用SaveAs 方法保存您的更改。

是否可以使用 IronWord 在 Word 文档中设置文本样式?

是的,IronWord 允许您在 Word 文档中设置文本样式和格式。您可以自定义字体、大小、颜色,并以编程方式应用其他格式选项。

IronWord 如何协助文档结构操作?

IronWord 提供文档结构操作功能,使开发人员能够处理段落、文字单元、图像、形状和表格,并管理页面设置和自定义页边距。

我需要在机器上安装 Microsoft Word 才能使用 IronWord 吗?

不,您不需要在机器上安装 Microsoft Word 就能使用 IronWord。该库独立于 Microsoft Word 和 Word Interop 运行。

IronWord 可以用于移动应用程序开发吗?

是的,IronWord 支持在 iOS 和 Android 等移动平台上进行开发,使其在跨平台应用程序开发中具有多功能性。

使用 IronWord 创建的 Word 文档保存过程是什么?

一旦您创建并修改了您的 WordDocument 实例,使用 SaveAs 方法将文档保存为文件,并指定所需的文件名和位置。

在哪里可以找到更多关于使用 IronWord 库的教程?

有关使用 IronWord 的更详细教程和代码示例,您可以参考其网站上提供的官方 IronWord 文档。

Jordi Bardia
软件工程师
Jordi 最擅长 Python、C# 和 C++,当他不在 Iron Software 利用这些技能时,他就在游戏编程。分享产品测试、产品开发和研究的责任,Jordi 在持续的产品改进中增加了巨大的价值。多样的经验使他面临挑战并保持投入,他表示这是在 Iron Software 工作的最喜欢的方面之一。Jordi 在佛罗里达州迈阿密长大,并在佛罗里达大学学习计算机科学和统计学。