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

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

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

何時應該使用直接文字添加？

透過 AddText 方法直接添加文字非常適合多種商業應用場景：

簡單文件產生：建立以文字內容為主要重點的簡單文檔，例如備忘錄、通知或簡單報告。

範本填充：用於填充文件範本中的佔位符文本，其中結構已定義，動態內容需要以程式設計方式插入。

批次處理：當處理多個需要添加類似文字的文件時，直接方法可以最大限度地減少程式碼複雜性並提高效能。

快速原型製作：在開發階段測試文件產生功能，而無需複雜的格式要求。

直接添加文字的方式是從程式碼到文件的最快路徑，因此當簡單性和速度比複雜的格式更重要時，這種方式是完美的。

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

在處理 DOCX 文件中的文字添加操作時，開發人員經常會遇到一些挑戰，這些挑戰可能會影響文件品質和應用程式穩定性：

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

文字溢位：過長的文字字串如果沒有自然換行符，可能會導致佈局問題。 對於篇幅較長的內容，可以考慮使用文字換行邏輯或段落分隔符號來保持可讀性。

記憶體注意事項：當以程式設計方式添加大量文字時，尤其是在循環或批次操作中，請監控記憶體使用情況。 IronWord針對效能進行了最佳化，但最佳實踐包括在使用後正確處置文件物件。

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

為什麼要使用基於段落的文本添加？

基於段落的文字添加方式比直接插入文字具有優勢，因此是複雜文件結構的首選方法：

結構組織：段落起到容器的作用，將相關內容分組，以便更好地組織文件並保持各部分之間的邏輯流程。

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

混合內容支援：段落可以包含多種內容類型——文字、圖像、超連結和內聯物件——從而實現豐富的文件組合，反映專業佈局。

專業文件標準：為了便於閱讀和保持專業外觀，商務文件通常遵循段落結構。 基於段落的新增方式可確保程式產生的文件符合這些標準。

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

將文字與其他文件元素結合起來需要了解段落結構以及不同類型的內容如何在其中相互作用：

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

using IronWord;
using IronWord.Models;

// 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
Imports IronWord.Models

' 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")

基於段落的方法可以實現複雜的文件佈局，使文字和視覺元素能夠相互配合。 這種方法尤其適用於：

報告產生：建立自動化報告，將資料視覺化與解釋性文字結合，確保元素之間正確的對齊和間距。

文件模板：建立可重複使用的模板，以便在保持格式一致性的同時，動態插入不同類型的內容。

多元素章節：建構文件章節，需要在同一個邏輯單元內混合使用文字、圖像、表格或其他物件。

段落文本的最佳實踐是什麼？

在進行基於段落的文字新增時，遵循最佳實務可確保文件品質和可維護性達到最佳水準：

邏輯內容分組：將相關內容放在同一段落。 對於不同的主題或想法，請建立新段落，以提高可讀性和結構性。

統一樣式：在整個文件中套用一致的段落樣式。 只需定義一次樣式屬性，即可在相似的段落中重複使用，以保持視覺一致性。

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

內容順序：按元素應出現的順序將其新增至段落。 雖然有些格式允許重新排序，但保持插入順序可以簡化偵錯並確保輸出可預測。

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

測試不同場景：測試基於段落的文字添加功能，並結合各種內容組合——純文字、文字加圖像、多個文字段——以確保您的實作能夠處理所有用例。

遵循這些做法，您可以建立強大的文件產生解決方案，產生專業、結構良好的 DOCX 文件，適用於商業應用程式和自動化報告系統。