1. IronWord
  2. 操作指南
  3. 编辑文本

How to Edit Text in a Word Document Using C

Ahmad Sohail
Ahmad Sohail
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

1.安装 IronWord NuGet 软件包

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

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronWord

    PM > 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");

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

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

    arrow pointer

最简工作流程(5 个步骤)

  1. 下载用于访问 Word 文档的 C# 库
  2. 加载现有的 DOCX 文件
  3. 导航至目标文本内容
  4. 通过 `Texts` 数组修改文本
  5. 导出更新后的 DOCX 文件

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

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

如果一个段落包含多种格式样式，则每个不同的段落段都是一个单独的文本段。

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

:path=/static-assets/word/content-code-examples/how-to/edit-text-simple.cs
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")
$vbLabelText   $csharpLabel

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

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

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

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

Word 文档显示修改后的文本，并带有多个彩色段落

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

如何编辑特定文本流？

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

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

  • 不同的字体样式(粗体、斜体、下划线)
  • 各种字体大小或颜色
  • 同一段落中的混合格式
  • 超链接或特殊字符 
:path=/static-assets/word/content-code-examples/how-to/edit-text-text-run.cs
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")
$vbLabelText   $csharpLabel

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

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

Word 文档显示文本运行修改前的红色、紫色和蓝色格式的三个文本段落

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

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

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
$vbLabelText   $csharpLabel

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

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

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

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

常见问题解答

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

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

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

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

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

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

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

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

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

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

Ahmad Sohail
Ahmad Sohail
  立即与工程团队聊天
全栈开发者

Ahmad 是一名全栈开发人员，拥有扎实的 C#、Python 和 Web 技术基础。他对构建可扩展的软件解决方案深感兴趣，并喜欢探索设计和功能在实际应用中如何结合。

在加入 Iron Software 团队之前，Ahmad 致力于自动化项目和 API 集成，专注于提高性能和开发人员体验。

在业余时间，他喜欢尝试 UI/UX 想法，贡献开源工具，并偶尔从事技术写作和文档工作，以便让复杂主题更易于理解。

准备开始了吗？
Nuget 下载 39,307 | 版本: 2026.4 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronWord
运行示例 观看您的数据变成 Word 文档。