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 套件
  2. 使用 WordDocument doc = new WordDocument("file.docx") 載入您的 DOCX 文件
  3. 存取段落：doc.Paragraphs[0]
  4. 修改文字：doc.Paragraphs[0].Texts[0].Text = "New text"
  5. 保存文件：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. 下載 C# 程式庫以存取 Word 文件
  2. 載入現有的 DOCX 文件
  3. 導航到目標文字內容
  4. 通過Textures陣列修改文字
  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 文件顯示兩段紅色和紫色斜體文字，顯示格式條帶

文字修改後有哪些變化？

Word 文件顯示在修改後具有多種顏色段落的被編輯文字

上圖中顯示的轉換說明了 IronWord 如何在文字編輯過程中保持文件完整性。 請注意，格式，包括顏色和樣式，保持一致，而僅有文字內容改變。 這種格式保持對於在業務應用中維持專業文件標準至關重要。

我如何編輯特定的文字段？

當段落包含多個具有不同格式的文字段時，您可以使用陣列索引來定位特定段。 文字段使用從零開始的索引，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，您可以透過載入一個DOCX檔案使用WordDocument，存取目標段落透過doc.Paragraphs[index]，並透過Texts陣列修改文字。例如：doc.Paragraphs[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和網頁技術堅實基礎的全端開發人員。他對構建可擴展的軟體解決方案深感興趣，並喜歡探索設計和功能在現實世界應用中的結合。

加入Iron Software團隊之前，Ahmad曾致力於自動化專案和API整合，專注於提升性能和開發者體驗。

在空閒時間，他喜歡試驗UI/UX理念，為開放原始碼工具做出貢獻，偶爾也會潛心編寫技術文件和文章以簡化複雜的主題。

準備開始了嗎？
Nuget 下載 49,323 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在滾動？

想要快速證明嗎？ PM > Install-Package IronWord
運行範例觀看您的資料變成Word檔。