.NET Word API（對開發人員的工作原理）

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

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

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

要在Visual Studio中建立一個新的C#控制台應用程式，請按照下列步驟操作。 控制台應用程式模板提供了一個簡單的學習起點，如何在整合功能到更大的應用程式（如Web服務或桌面軟體）之前，生成Word文件。

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

開發Visual Studio時的啟動畫面，顯示建立新項目的按鈕，用於開始一個新的C#控制台應用程式。

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

Visual Studio中項目模板選擇窗口顯示控制台應用程式模板選項，並應用了C#語言篩選器。

3. 輸入項目名稱和位置。 單擊下一步，選擇.NET 6.0或更高版本，然後單擊建立。

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

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

IronWord在Word文件處理方面提供了多個優勢。 與某些需要在伺服器或開發機上安裝Microsoft Office的替代方案不同，IronWord獨立運行，非常適合云部署、容器化應用程式及Office安裝不可行的環境。 此程式庫支持多種文件元素，包括段落、表格、圖片、頁眉、頁腳、樣式和格式選項，讓您能夠完全掌控文件的外觀和結構。

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

讓我們從一個實用的例子開始，展示如何使用IronWord在C#中將資料匯出到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");

Imports IronWord
Imports IronWord.Models

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

' Create textRun which is a part of a paragraph content
Dim textRun As New Text(userInput)
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)

' Create a new document object and add the paragraph to it
Dim doc As New WordDocument(paragraph)

' Export document to "document.docx" file
doc.SaveAs("document.docx")

在此範例中，我們正在建立一個包含用户文字的單一段落的簡單Word文件。 讓我們逐步解析程式碼：

1. 導入需要的程式庫：我們首先從IronWord導入所需的命名空間。 IronWord命名空間包含主要文件類，而IronWord.Models提供內容模型類。
2. 建立文字內容：我們建立了一個Text物件，代表要在Word文件中包括的文字內容。 在這種情況下，它是從控制字元收集的userInput。
3. 建立段落：接下來，我們建立一個textRun）作為子元素。 Word中的段落通常包含一個或多個文字內容運行，這允許在單個段落內混合格式。
4. 建立Word文件：我們實例化一個新WordDocument物件，將我們建立的段落作為參數傳遞。 這將根據指定內容初始化一個新的Word文件。
5. 匯出文件：最後，我們在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");

Imports IronWord
Imports IronWord.Models

' Create a document with multiple formatted paragraphs
Dim doc As New WordDocument()

' Add a title paragraph with bold formatting
Dim titleParagraph As New Paragraph()
Dim titleText As New Text("Sales Report Q4 2024")
titleText.Style = New TextStyle() With {.Bold = True, .FontSize = 24}
titleParagraph.AddChild(titleText)
doc.AddChild(titleParagraph)

' Add a regular paragraph with mixed formatting
Dim contentParagraph As New Paragraph()
Dim normalText As New Text("Total revenue for Q4 was ")
Dim emphasizedText As New Text("$1.2 million")
emphasizedText.Style = New TextStyle() With {.Bold = True, .Italic = True}
Dim endText As 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和穩固的性能，使其成為小型應用程式和Enterprise級文件處理系統的理想選擇。 隨著您不斷探索IronWord的能力，您將發現多種方式來改進文件生成過程，為用户的文件需求提供更好的解決方案。

欲了解更多自動化Microsoft Word文件生成的技術，請存取以下連結。