How to Edit Text in a Word Document Using C#

Updated: 2026年5月9日

IronWord 通过提供段落文本运行的访问权限，可以在 Word 文档中直接进行文本编辑。您可以通过程序修改现有的 DOCX 内容，精确控制格式段。

快速入门：编辑Word文档中的文本

安装IronWord NuGet包
使用WordDocument doc = new WordDocument("file.docx")加载您的DOCX文件
访问段落：doc.Paragraphs[0]
修改文本：doc.Paragraphs[0].Texts[0].Text = "New text"
保存文档：doc.SaveAs("edited.docx")

1Install IronWord with NuGet Package Manager
PM > Install-Package IronWord
```
Install-Package IronWord
```

2复制并运行这段代码。

using IronWord;

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

// Edit first paragraph text
doc.Paragraphs[0].Texts[0].Text = "Updated content";

// Save changes
doc.SaveAs("updated.docx");

using IronWord;

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

// Edit first paragraph text
doc.Paragraphs[0].Texts[0].Text = "Updated content";

// Save changes
doc.SaveAs("updated.docx");

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronWord

最简工作流程（5 个步骤）

下载用于访问 Word 文档的 C# 库

加载现有的 DOCX 文件

导航至目标文本内容

通过 Texts 数组修改文本

导出更新后的 DOCX 文件

如何编辑 Word 文档中的文本？

要编辑 Word 文档中的文本，请加载现有文件并访问目标段落。段落暴露了一个Texts[0]引用了该段落中的第一个文本运行。文本段是指格式一致的文本部分。这种方法既能保持文档的原始结构，又能以编程方式更新特定内容。

提示: 如果段落包含多种格式样式，每个不同的部分是一个独立的文本运行。

在处理商业文件时，您需要在不影响整体格式的情况下更新特定部分。 IronWord 保留了文档的布局、样式和格式，同时允许对文本进行精确修改。这对于更新模板文档、个性化表单信函或维护动态报告非常有效。

using IronWord;

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

// Edit existing text on the first paragraph
doc.Paragraphs[0].Texts[0].Text = "First paragraph is updated successfully";

// Export docx
doc.SaveAs("edited_document.docx");

using IronWord;

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

// Edit existing text on the first paragraph
doc.Paragraphs[0].Texts[0].Text = "First paragraph is updated successfully";

// Export docx
doc.SaveAs("edited_document.docx");

Imports IronWord

' Load a DOCX document
Dim doc As New WordDocument("raw_document.docx")

' Edit existing text on the first paragraph
doc.Paragraphs(0).Texts(0).Text = "First paragraph is updated successfully"

' Export docx
doc.SaveAs("edited_document.docx")

Imports IronWord

' Load a DOCX document
Dim doc As New WordDocument("raw_document.docx")

' Edit existing text on the first paragraph
doc.Paragraphs(0).Texts(0).Text = "First paragraph is updated successfully"

' Export docx
doc.SaveAs("edited_document.docx")

上面的代码演示了文本编辑的基本方法。加载文档时，IronWord 会将其结构解析为对象的层次结构。每个段落包含一个或多个文本流，这些文本流可以独立访问和修改。这种细粒度控制可确保在内容发生变化的同时，格式保持不变。

编辑前的文档是什么样的？

Word 文档显示了两个 Lorem ipsum 段落，分别为红色和紫色斜体文本，格式化功能区可见

文本修改后会发生哪些变化？

上图所示的转换说明了 IronWord 如何在文本编辑过程中保持文档的完整性。请注意，格式（包括颜色和样式）保持一致，只有文本内容有所变化。这种格式的保留对于在商业应用中保持专业文档标准至关重要。

如何编辑特定文本流？

当一个段落包含多个格式不同的文本行时，可以使用数组索引来定位特定的文本行。文本运行使用从零开始的索引，其中Texts[1]是第二个，以此类推。在此示例中，我们使用Paragraphs[3].Texts[1]定位第四段的第二个文本运行。

理解文本运行对于精确编辑文档至关重要。如果包含以下内容，一个段落可能包含多个文本流：

不同的字体样式（粗体、斜体、下划线）
各种字体大小或颜色
相同段落内的混合格式
超链接或特殊字符

using IronWord;

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

// Edit second text run in the 4th paragraph
doc.Paragraphs[3].Texts[1].Text = "Edited the textrun successfully within the same paragraph";

// Save to the same file
doc.SaveAs("text_document.docx");

using IronWord;

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

// Edit second text run in the 4th paragraph
doc.Paragraphs[3].Texts[1].Text = "Edited the textrun successfully within the same paragraph";

// Save to the same file
doc.SaveAs("text_document.docx");

Imports IronWord

' Load the document
Dim doc As New WordDocument("text_document.docx")

' Edit second text run in the 4th paragraph
doc.Paragraphs(3).Texts(1).Text = "Edited the textrun successfully within the same paragraph"

' Save to the same file
doc.SaveAs("text_document.docx")

Imports IronWord

' Load the document
Dim doc As New WordDocument("text_document.docx")

' Edit second text run in the 4th paragraph
doc.Paragraphs(3).Texts(1).Text = "Edited the textrun successfully within the same paragraph"

' Save to the same file
doc.SaveAs("text_document.docx")

这种方法可在更新文档时提供外科手术般的精确度。例如，如果您有一个段落，其中只有某些单词加粗或着色不同，那么每次格式更改都会创建一个新的文本运行。针对特定的运行，您只需更新所需的内容，而不会影响周围的文本或格式。

为什么文本流对于格式化很重要？

文本运行是 Word 格式化系统的基础。每个运行都有自己的一套属性，包括字体家族、大小、颜色和样式属性。当您编辑特定文本运行时，这些属性保持不变，确保您的文档保持专业外观。在使用企业模板或品牌文档时，这一点尤为重要，因为在这些文档中，格式必须保持一致。

当我锁定特定文本运行时会发生什么？

可视化反馈可以准确显示修改了哪些文本。这种精确的编辑能力对于需要进行以下工作的应用程序非常有价值：

更新表单模板中的特定字段
修改合同文档中的变量
更改营销材料中的占位符
更新报告中的数据点，同时保留格式

文本编辑的最佳实践

在应用程序中实现文本编辑功能时，请考虑以下最佳实践：

错误处理：在尝试修改段落和文本运行之前，请务必验证它们是否存在。使用边界检查防止索引超出范围异常：

if (doc.Paragraphs.Count > 0 && doc.Paragraphs[0].Texts.Count > 0)
{
    doc.Paragraphs[0].Texts[0].Text = "Safe update";
}

if (doc.Paragraphs.Count > 0 && doc.Paragraphs[0].Texts.Count > 0)
{
    doc.Paragraphs[0].Texts[0].Text = "Safe update";
}

If doc.Paragraphs.Count > 0 AndAlso doc.Paragraphs(0).Texts.Count > 0 Then
    doc.Paragraphs(0).Texts(0).Text = "Safe update"
End If

If doc.Paragraphs.Count > 0 AndAlso doc.Paragraphs(0).Texts.Count > 0 Then
    doc.Paragraphs(0).Texts(0).Text = "Safe update"
End If

保留格式：请记住，每个文本运行都有自己的格式。如果需要保持已编辑文本格式的一致性，可能需要适当合并或拆分文本运行。

性能考虑因素：编辑多个文本元素时，请加载一次文档，进行所有必要的更改，并在最后保存一次。这种方法可以最大限度地减少 I/O 操作并提高性能。

文档备份：在进行大量编辑之前，请考虑创建原始文档的备份副本。这种做法可确保数据安全，并在需要时提供回滚选项。

通过遵循这些准则并了解文本运行结构，您可以构建强大的文档编辑解决方案，在保持专业质量的同时，高效地实现内容更新自动化。

常见问题解答

如何使用 C# 编辑现有 Word 文档中的文本？

using IronWord，您可以使用 WordDocument 加载 DOCX 文件，通过 doc.Paragraphs[index] 访问目标段落，并通过 Texts 数组修改文本，从而编辑文本。例如：doc.Partagraph[0].Texts[0].Text = "New text"。IronWord 在更新内容的同时保留了原始格式。

什么是 Word 文档中的文本运行？

文本流是段落中格式一致的文本片段。IronWord 将其作为 Texts 数组中的元素公开，允许您独立修改特定的格式段。如果一个段落包含多种格式样式，则每个不同的段落都将成为一个单独的文本流。

编辑文本是否会影响文档格式？

不，IronWord 会在您编辑文档时保留文档的布局、样式和格式。该库可在修改过程中保持文档的完整性，确保颜色、字体和其他格式保持一致，而仅文本内容发生变化。

我能否以编程方式更新模板文档？

是的，IronWord 是更新模板文档、个性化表单信函或维护动态报告的理想选择。您可以加载现有的 DOCX 模板，以编程方式修改特定文本部分，同时保留文档的整体结构和格式。

编辑 Word 文档后如何保存更改？

using IronWord 修改文本后，请使用 SaveAs 方法保存更改。例如：doc.SaveAs("updated.docx")。这将创建一个包含编辑内容的新文件，同时保持文档的原始格式和结构。

How do I ensure text modifications do not throw errors in IronWord?

Before modifying text, verify that the targeted paragraphs and text runs exist using bounds checking. This prevents index out of range exceptions during editing.

What best practices should be followed when editing Word documents using IronWord?

When editing Word documents, it's advisable to check text run bounds, preserve formatting by merging or splitting runs as needed, minimize input/output operations for performance, and back up the original document before extensive edits.

How can I preserve a document's layout while updating its content?

IronWord allows you to update specific content without altering the document's layout by providing access to text runs. Modify only the desired text run while keeping other formatting intact to maintain the document's structure.