如何在C#中建立DOCX文件

介紹

在當今數位環境中，許多應用程式需要具備自動生成和修改文件的能力。 無論您是在建立企業級報告系統、文件管理系統，或者只是自動化重複性活動，創建和操作 DOCX 文件的能力都是非常有用的。 在本教程中，我們將深入探討 C# 文件生成的世界，並檢視可用於 C# 的各類強大函式庫及程式設計方法來創建 DOCX 文件。

如何在C#中創建DOCX文件

1. 安裝 NuGet 套件 IronWord。

2. 從 IronWord 中提取所需的命名空間並導入它們。

3. 若要生成文件檔案，新增一個新的TextRun。

4. 創建新 Body 和 Document。

5. 用內容填充正文(段落、表格等等。).

6. 使用 WordDocument，創建一個新的 WordDocument。

7. 將 Document 物件指派給 TextRun、Paragraph 的 Document 屬性將保存這些修改。

了解 DOCX 格式

在深入編碼之前，讓我們先釐清什麼是 DOCX 文件。 Microsoft Word 和其他文字處理程式將文件儲存為 DOCX 檔案格式。 它是基於ZIP壓縮的XML格式的[Office Open XML(OOXML) 標準](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(也非正式地，初始版本為ECMA-376。). 這允許使用來自微軟和其他開發人員的 API，以相對簡單的方式進行程式化操作。

IronWord

Iron Software 創建了稱為 IronWord 的 Word 文件庫IronWord. 在為 .NET 應用程式提供強大 Word 文件操作功能方面。 IronWord 為 .NET C# 開發人員提供了一個強大的工具庫，能夠在其程式中創建、讀取和修改 Word 和 DOCX 文件。

IronWord 的功能

• 建立和編輯 DOC 與 DOCX：IronWord 透過允許您直接在 .NET 專案中創建和編輯 Word 文檔，來消除對 Office Interop 或 Microsoft Word 安裝的需求。
• 打開、編輯現有文件，並保存 Word 文件和 Docx：Word 文檔結構是可自訂的，包括頁面配置。(背景顏色、邊距、紙張大小和方向).
• 包含文字和圖片：使用簡單的 API，您可以快速將文字和圖形添加到您的 Word 文件中。
• 跨平台支援：IronWord 相容於 .NET 8、7、6、Core、Standard 或 Framework，並為 C#、F# 和 VB.NET 所建置。 它可以在多種環境下運作，例如 Docker、iOS、Android、Windows 和 Linux。

• 全球數以百萬計的工程師依賴我們：IronWord 是 Iron Suite 的一個組件，該套件由九個 .NET API 辦公文件產品組成。 世界各地的開發人員使用它來創建、查看和修改 Word 文檔。

  要了解更多關於 IronWord 的資訊，請參閱這裡.

在 Visual Studio 中建立新專案

要啟動 Visual Studio 應用程式，請使用檔案選單並選擇檔案。點擊「新增專案」，然後選擇「主控台應用程式」。

在選擇文件位置後，在指定的文本欄位中輸入專案名稱。 接下來，如以下範例所示，點擊「建立」按鈕並選擇所需的 .NET Framework。

Visual Studio 專案的組織將取決於所選的應用程式。 要添加程式碼並構建應用程式，只需打開 program.cs 檔案。這可以用於網路應用程式、Windows 或主控台。

之後，可以添加庫並測試代碼。

安裝 IronWord 庫

使用 Visual Studio 工具 從工具選單中選擇 NuGet 套件管理器。 進入套件管理器介面以訪問套件管理終端控制台。

Install-Package IronWord

下載並安裝套件後，現在可以在進行中的項目中使用。

還有套件管理器方法。 可以使用 Visual Studio 的 NuGet 套件管理器選項將套件直接安裝到解決方案中。 您可以在下圖中看到如何啟動 NuGet 封裝管理器。

使用 NuGet 網站的搜索框來尋找套件。 我們只需要在套件管理器中查找「IronWord」，如下圖所示：

相關搜尋結果的列表顯示在上圖中。 要在您的計算機上安裝軟體，只需調整這些設置。

使用 IronWord 建立 DOCX

實例化一個 WordDocument 物件來開始新的 Word 文件。 要初始化文件，您可以使用構成文件結構的任何物件，如段落、表格或章節。 以下的程式碼片段是一個簡單的例子：

using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}

using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}

Imports IronWord
Imports IronWord.Models
Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run
			Dim textRun As New TextRun("Hello, IronPdf")
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)
			' Create a new document
			Dim doc As New WordDocument(paragraph)
			' Export the DOCX file
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace

我們可以透過 TextRun 類別將文字添加到文檔中，這允許我們使用 AddTextRun 方法將文字傳入段落物件。 然後，我們創建一個新的 WordDocument 物件來建立一個新的 DOCX 檔案。然後，透過使用 SaveAs 方法，我們可以將新的 DOCX 文件儲存在所需的位置。 以下是從上述程式碼生成的輸出。

瞭解有關 IronWord 代碼的更多資訊請參閱這裡.

結論

在本指南中，我們已經探討了如何使用 C# 來生成 DOCX 文檔文件。我們討論了 DOCX 格式的基本知識，以及 Open XML SDK 和 DocX 庫，並提供了使用它們生成、編輯和保存 DOCX 文件的示例。

所有這些工具和方法都將使您在 C# 專案中處理各種文件創建任務時處於有利位置。 學習使用 C# 製作文檔是一項有用的能力，無論您是在自動化生成報告、開發文檔管理系統或只是為最終用戶製作模板，都能幫助您應對各種情況。

對於使用 .NET C# 的開發人員，IronWord是一個強大且可調整的 Word 文件庫。 它使開發人員能夠讀取、寫入和編輯 Word 文檔(DOCX)在他們的應用程式中輕鬆處理文件。 IronWord 的用户友好 API 使處理 Word 文件更加簡單。 開發人員無需安裝 Microsoft Word 或倚賴 Office Interop，即可直接在其 .NET 專案中建立和編輯 Word 檔案。 將文字、段落和其他元素新增至新的 Word 文件變得非常簡單。

IronWord 在剛推出時是 $749。 此外，支付一年度會員費的客戶可以獲得產品的協助和更新。 IronWord 提供防止無限制再分配的服務，但需要支付費用。 如需了解更多相關費用，請訪問此頁面. 點擊此處查看更多關於 Iron Software 的資訊連結.