使用 C# 创建 Word 文档的简易教程（快速上手）

在现代软件开发中，生成文档自动化变得越来越重要。借助像 Spire.Doc for .NET 这样的库，我们可以轻松地在 C# 中创建和操作 Word 文档。本文将介绍如何使用 Spire.Doc 创建一个简单的 Word 文档，涉及到标题、段落等文本元素的添加。

Spire.Doc for .NET 简介

Spire.Doc 是一款功能强大的 .NET 文档处理组件，它允许开发者在 C# 和 VB.NET 中创建、读取、编辑和保存 Word 文档。该库支持多种格式，包括 DOC、DOCX、HTML 和 PDF。用户可以简单地通过代码来控制文档的内容和样式，进而生成满足需求的文档。

NuGet 安装

要在项目中使用 Spire.Doc，你可以通过 NuGet 包管理器轻松安装。只需在命令行中输入以下命令：

Install-Package Spire.Doc

安装完成后，你就可以开始使用 Spire.Doc 创建 Word 文档了。

示例代码

下面的代码示例展示了如何使用 C# 和 Spire.Doc 创建一个包含标题和段落的简单 Word 文档。

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing;

namespace CreateSimpleWordDocument
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建Document对象
            Document document = new Document();

            // 添加节
            Section section = document.AddSection();

            // 设置页边距
            section.PageSetup.Margins.All = 60f;

            // 添加一个标题段落
            Paragraph title_para = section.AddParagraph();
            TextRange textRange = title_para.AppendText("这是标题");
            title_para.ApplyStyle(BuiltinStyle.Title);
            textRange.CharacterFormat.FontName = "宋体";

            // 添加几个小标题段落
            string[] headings = { "这是标题1", "这是标题2", "这是标题3", "这是标题4" };
            for (int i = 0; i < headings.Length; i++)
            {
                Paragraph heading = section.AddParagraph();
                textRange = heading.AppendText(headings[i]);
                heading.ApplyStyle((BuiltinStyle)((int)BuiltinStyle.Heading1 + i));
                textRange.CharacterFormat.FontName = "宋体";
            }

            // 添加一个段落
            Paragraph normal_para = section.AddParagraph();
            normal_para.AppendText("这是一个段落。");

            // 创建段落样式
            ParagraphStyle style = new ParagraphStyle(document);
            style.Name = "paraStyle";
            style.CharacterFormat.FontName = "宋体";
            style.CharacterFormat.FontSize = 13f;
            style.CharacterFormat.TextColor = Color.Brown;
            document.Styles.Add(style);

            // 将自定义样式应用到指定段落
            normal_para.ApplyStyle("paraStyle");

            // 保存文档
            document.SaveToFile("AddText.docx", FileFormat.Docx);

            // 释放资源
            document.Dispose();
        }
    }
}

代码详解

1. 创建 Document 对象 ：首先，我们实例化一个 Document 对象，这是文档的核心。
2. 添加节 ：使用 AddSection() 方法，我们可以向文档添加新的节。
3. 设置页面边距 ：使用 PageSetup.Margins 属性可以轻松设置页边距。
4. 添加标题和段落 ：
   1. 我们可以通过 AddParagraph() 方法添加段落，并利用 AppendText() 方法添加文本。
   2. Spire.Doc 允许使用内置样式，通过 ApplyStyle() 方法为段落应用不同的样式。
5. 自定义段落样式 ：使用 ParagraphStyle 类，我们可以定义自己的段落样式并应用到段落上。
6. 保存文档 ：最后，我们使用 SaveToFile() 方法将文档保存为 .docx 格式。

更多功能

如果想要了解如何在 Word 文档中添加图片、列表等更复杂的元素，可以参考 Spire.Doc 的在线教程。这些教程涵盖了库的更多先进功能，帮助你更好地掌握文档生成的技术。

结论

通过本文的介绍，你应该能够使用 C# 和 Spire.Doc 创建一个包含基本元素的 Word 文档。无论是生成报告、合同或其他任何文档，Spire.Doc 都提供了丰富的功能，满足各种需求。继续探索更多特性，你将能创建出更加复杂和专业的文档。