如何使用 IronWord 在 C# DOCX 中新增文字。

添加文字的最簡單方法是什麼？

<! -- --> <！--說明：說明程式碼概念的圖表或截圖 -->

最直接的方法是建立 WordDocument 範例，並使用 AddText 方法。 此方法可自動處理所有底層 DOCX 結構，讓您專注於內容創作。

何時應該使用直接文字新增？

透過 AddText 方法直接新增文字是多種商業應用程式情境的理想選擇：

簡易文件生成：在建立備忘錄、通知或簡單報告等以文字內容為主要重點的簡單文件時。

範本人口：用於在結構已定義且動態內容需要程式化插入的文件範本中填入占位符文字。

批次處理：當處理需要類似文字新增的多個文件時，直接的方式可將程式碼的複雜度降至最低，並提高效能。

快速原型：在沒有複雜格式要求的開發階段測試文件產生功能。

直接增加文字的方式提供了從程式碼到文件的最快路徑，當簡單性和速度比複雜的格式更為優先時，這種方式是最完美的。

新增文字時有哪些常見問題？

開發人員在處理 DOCX 檔案中的新增文字時，經常會遇到可能影響文件品質和應用程式穩定性的挑戰：

字元編碼問題：特殊字符、Unicode 符號或不同語言的腳本如果沒有適當的編碼，可能無法正確呈現。 IronWord 會自動管理編碼，但會確保原始文字以 UTF-8 正確編碼。

文字溢出：沒有自然分隔的長文字串可能會造成排版問題。 對於冗長的內容，可考慮實施文字包覆邏輯或段落分隔，以維持可讀性。

記憶體考量：以程式化方式新增大量文字時，尤其是在循環或批次作業中，請監控記憶體使用量。 IronWord 已針對效能進行最佳化，但最佳實務包括使用後妥善處置文件物件。

格式保留：純文字新增不會保留來源格式，例如粗體、斜體或顏色。 對於格式化的文字，請使用具有特定格式屬性的樣式段落或文字運行。

為什麼要使用段落式文字新增？

與直接插入文字相比，以段落為基礎的文字新增具有優勢，因此是複雜文件結構的首選方法：

結構組織：段落可作為將相關內容組合的容器，使文件組織更順暢，並維持各節之間的邏輯流程。

樣式一致性：在段落中加入文字可在段落層級套用一致的格式，包括對齊、間距、縮排以及影響所有包含文字的其他屬性。

混合內容支援：段落可包含多種內容類型 - 文字、圖片、超連結和內嵌物件 - 可讓豐富的文件組成反映專業的佈局。

Professional Document Standards（專業文件標準）： 商業文件通常遵循以段落為基礎的結構，以達到可讀性和專業外觀。 以段落為基礎的新增功能可確保程式化產生的文件符合這些標準。

如何將文字與其他元素結合？

將文字與其他文件元素結合，需要瞭解段落結構以及不同內容類型如何在其中互動：

:path=/static-assets/word/content-code-examples/how-to/add-text-add-paragraph.cs

using IronWord;

// Create a blank document
WordDocument paragraphDoc = new WordDocument();

// Instantiate a paragraph object
Paragraph paragraph = new Paragraph();

// Add text to paragraph
TextContent text = new TextContent("This is a horse.");
paragraph.AddText(text);

// Add image to paragraph
ImageContent image = new ImageContent("add-text-add-paragraph.jpg");
image.Width = 100;
image.Height = 100;
paragraph.AddImage(image);

// Add paragraph to document
paragraphDoc.AddParagraph(paragraph);

// Export the document
paragraphDoc.SaveAs("addtext_paragraph.docx");

Imports IronWord

' Create a blank document
Dim paragraphDoc As New WordDocument()

' Instantiate a paragraph object
Dim paragraph As New Paragraph()

' Add text to paragraph
Dim text As New TextContent("This is a horse.")
paragraph.AddText(text)

' Add image to paragraph
Dim image As New ImageContent("add-text-add-paragraph.jpg")
image.Width = 100
image.Height = 100
paragraph.AddImage(image)

' Add paragraph to document
paragraphDoc.AddParagraph(paragraph)

' Export the document
paragraphDoc.SaveAs("addtext_paragraph.docx")

以段落為基礎的方法允許複雜的文件佈局，讓文字和視覺元素共同運作。 此方法對於下列情況特別有效

報告產生：建立結合資料可視化與說明文字的自動化報告，並確保元素之間有適當的對齊與間距。

文件範本：建立可重複使用的範本，其中不同的內容類型需要動態插入，同時保持格式一致。

多元素章節：建構需要在同一邏輯單位內混合文字、圖片、表格或其他物件的文件區段。

什麼是段落文字的最佳實作？

在使用以段落為基礎的新增文字時，遵循最佳實務可確保最佳的文件品質與可維護性：

邏輯內容群組：將相關內容保持在同一段落中。 對於明顯的主題或想法，可建立新的段落以改善可讀性和結構。

一致的樣式：在整個文件中一致地應用段落樣式。 定義一次樣式屬性，並在類似的段落中重複使用，以維持視覺上的一致性。

效能最佳化：新增多個段落時，請先在記憶體中建立這些段落，然後再新增到文件中。 這可減少文件修改並提高效能。

內容順序：按應該出現的順序將元素添加到段落中。 雖然某些格式允許重新排序，但維持插入順序可簡化除錯工作並確保輸出的可預測性。

資源管理：在段落中使用圖片或外部資源時，確保適當的資源處理，並考慮檔案大小對最終文件的影響。

Testing Different Scenarios：使用各種內容組合測試以段落為基礎的文字新增功能 - 僅文字、有影像的文字、多段文字 - 以確保您的實作能夠處理所有使用個案。

遵循這些做法，您就能建立強大的文件產生解決方案，產生專業、結構良好的 DOCX 檔案，適合商業應用程式和自動報表系統使用。