如何在 C# 中導出文檔至 Word

如何在 C# 中將文件匯出為 Word 文件？

1. 建立一個新的 C# Visual Studio 專案。
2. 安裝 C# Word 庫，以便將資料匯出到 Word。
3. 導入 Word 庫的依賴項。
4. 使用"new WordDocument(paragraph)"方法建立一個新的 Word 文件。
5. 使用"SaveAs()"函數儲存新建立的 Word 文件。

如何建立一個新的 C# 控制台應用程式？

若要在 Visual Studio 中建立新的 C# 控制台應用程序，請依照下列步驟操作。 控制台應用程式範本提供了一個簡單的起點，用於學習如何產生 Word 文檔，然後再將該功能整合到更大的應用程式（如 Web 服務或桌面軟體）中。

1. 開啟 Visual Studio。 在啟動畫面上，選擇"建立新項目"。

2. 選擇"控制台應用程式"，然後按一下"下一步"。 如果出現多個選項，請選擇 C# 版本。

3. 輸入項目名稱和地點。 按一下"下一步"，選擇.NET 6.0 或更高版本，然後按一下"建立"。

IronWord是什麼？我為什麼要使用它？

IronWord是一個.NET函式庫，它提供了一個方便的 API，用於在 C# 中處理 Word 文件。 它允許開發人員建立 Word 文檔、修改現有文檔，並將其匯出到他們的 C# 應用程式中。 使用IronWord，您可以根據來自各種來源（例如資料庫、API 或使用者輸入）的資料動態產生 Word 文件。 該程式庫處理所有複雜的底層 Office Open XML 規範，可讓您專注於業務邏輯，而不是文件格式的複雜性。

IronWord為 Word 文件處理提供了許多優勢。 與某些需要在伺服器或開發機器上安裝 Microsoft Office 的替代方案不同， IronWord可以獨立運行，因此非常適合雲端部署、容器化應用程式以及無法安裝 Office 的環境。 此庫支援多種文件元素，包括段落、表格、圖像、頁首、頁尾、樣式和格式選項，讓您可以完全控製文件的外觀和結構。

如何使用IronWord將資料匯出到 Word 文件？

讓我們從使用 C# 中的IronWord將資料匯出到 Word 文件的實際範例開始。 以下程式碼片段示範了建立簡單 Word 文件的基本流程：

using IronWord;
using IronWord.Models;

System.Console.WriteLine("Enter the Text to export it to word document");
var userInput = System.Console.ReadLine();

// Create textRun which is a part of a paragraph content
Text textRun = new Text(userInput);
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);

// Create a new document object and add the paragraph to it
WordDocument doc = new WordDocument(paragraph);

// Export document to "document.docx" file
doc.SaveAs("document.docx");

using IronWord;
using IronWord.Models;

System.Console.WriteLine("Enter the Text to export it to word document");
var userInput = System.Console.ReadLine();

// Create textRun which is a part of a paragraph content
Text textRun = new Text(userInput);
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);

// Create a new document object and add the paragraph to it
WordDocument doc = new WordDocument(paragraph);

// Export document to "document.docx" file
doc.SaveAs("document.docx");

在這個例子中，我們將建立一個簡單的 Word 文檔，其中包含一個段落，內容為使用者提供的文字。 讓我們一步一步地分析程式碼： 1.導​​入所需庫：我們先從IronWord導入必要的命名空間。 IronWord命名空間包含主要文檔類，而 IronWord.Models 提供內容模型類。 2.建立文字內容：我們建立一個 Text 對象，表示我們要在 Word 文件中包含的文字內容。 在這種情況下，它是從控制台收集到的 userInput。 3.建立段落：接下來，我們建立一個 Paragraph 對象，並將 Text 物件 (textRun) 作為子元素新增至該物件中。 Word 文件中的一個段落通常包含一個或多個文字段，允許在單一段落中使用混合格式。 4.建立 Word 文件：我們實例化一個新的 WordDocument 對象，並將我們創建的段落作為參數傳遞。 這將使用指定的內容建立一個新的 Word 文件。 5.匯出文件：最後，我們呼叫 SaveAs 物件上的 WordDocument 方法，將文件匯出到名為"document.docx"的 .docx 檔案。預設情況下，該檔案會保存在應用程式的工作目錄中。

本範例示範了使用IronWord將資料匯出到 Word 文件的基本工作流程。 您可以根據具體需求自訂現有 Word 文件的內容和結構。 例如，您可以新增多個段落、設定文字格式、插入表格、圖像、頁首、頁尾等等。

如何在 Word 文件中新增更複雜的內容？

雖然基本範例僅展示了簡單的文字匯出，但IronWord支援更複雜的文件建立。 以下範例示範如何新增包含多個段落和樣式的格式化文字：

using IronWord;
using IronWord.Models;

// Create a document with multiple formatted paragraphs
WordDocument doc = new WordDocument();

// Add a title paragraph with bold formatting
Paragraph titleParagraph = new Paragraph();
Text titleText = new Text("Sales Report Q4 2024");
titleText.Style = new TextStyle() { Bold = true, FontSize = 24 };
titleParagraph.AddChild(titleText);
doc.AddChild(titleParagraph);

// Add a regular paragraph with mixed formatting
Paragraph contentParagraph = new Paragraph();
Text normalText = new Text("Total revenue for Q4 was ");
Text emphasizedText = new Text("$1.2 million");
emphasizedText.Style = new TextStyle() { Bold = true, Italic = true };
Text endText = new Text(", exceeding projections by 15%.");

contentParagraph.AddChild(normalText);
contentParagraph.AddChild(emphasizedText);
contentParagraph.AddChild(endText);
doc.AddChild(contentParagraph);

// Save the formatted document
doc.SaveAs("quarterly_report.docx");

using IronWord;
using IronWord.Models;

// Create a document with multiple formatted paragraphs
WordDocument doc = new WordDocument();

// Add a title paragraph with bold formatting
Paragraph titleParagraph = new Paragraph();
Text titleText = new Text("Sales Report Q4 2024");
titleText.Style = new TextStyle() { Bold = true, FontSize = 24 };
titleParagraph.AddChild(titleText);
doc.AddChild(titleParagraph);

// Add a regular paragraph with mixed formatting
Paragraph contentParagraph = new Paragraph();
Text normalText = new Text("Total revenue for Q4 was ");
Text emphasizedText = new Text("$1.2 million");
emphasizedText.Style = new TextStyle() { Bold = true, Italic = true };
Text endText = new Text(", exceeding projections by 15%.");

contentParagraph.AddChild(normalText);
contentParagraph.AddChild(emphasizedText);
contentParagraph.AddChild(endText);
doc.AddChild(contentParagraph);

// Save the formatted document
doc.SaveAs("quarterly_report.docx");

本範例示範如何建立具有不同格式的文檔，使匯出的文檔更專業、更具視覺吸引力。 TextStyle 類別提供了用於控製字體系列、大小、顏色、粗體、斜體、底線和其他文字屬性的屬性。

程式化匯出 Word 文件的常見用例有哪些？

了解實際應用程式有助於直觀地了解 Word 文件匯出功能如何為您的專案帶來好處。 以下幾個常見場景中，程式化文件產生功能都發揮了至關重要的作用：

發票和收據產生：從計費系統中自動建立包含抬頭、表格和付款條款的專業發票。

報告自動化：自動產生定期財務摘要、績效指標或合規性文件。

郵件合併操作：透過將資料庫記錄合併到範本中來建立個人化的合約、信件或證書。

文檔系統：將原始碼註解或資料庫模式轉換為格式化的技術文件。

表單處理：將網頁表單或調查回應轉換為格式化的 Word 文檔，供利害關係人審查。

有哪些關鍵要點？

總而言之， IronWord提供了一個完整的解決方案，用於使用 C# 將資料匯出到 Word 文件。 無論您是產生簡單的報表、複雜的文件或動態內容， IronWord都能簡化流程，讓開發人員能夠以程式設計方式建立高品質的 Word 文件。 利用其特性和功能，您可以簡化文件產生工作流程，並向使用者提供專業文件。

該程式庫無需安裝 Microsoft Office，並且具有完整的 API 和可靠的效能，使其成為小型應用程式和企業級文件處理系統的理想選擇。 隨著您不斷探索 IronWord 的功能，您會發現許多方法來改善文件產生流程，並為使用者的文件需求提供更好的解決方案。

若要了解更多自動產生 Microsoft Word 文件的技巧，請造訪以下連結。