使用 IRONWORD

如何在 C# 中不使用 Office Interop 創建 Word 文檔

Q: 如何在使用 IronWORD 的 Word 文檔中添加樣式文本？

IronWORD 允許您使用 TextRun 和 TextStyle 類別添加樣式文本。這些類別允許您在 Word 文件中的特定文本段中應用加粗、斜體和下劃線等樣式。

Q: 如何使用 IronWORD 在 Word 文件中插入圖片？

要使用 IronWORD 在 Word 文件中插入圖片，您可以使用 IronWord.Models.Image 類將具有指定尺寸的圖片嵌入到段落中，從而提升文件的視覺內容。

更新:2025年11月5日

Microsoft Word 文件用途廣泛，從正式的商業報告到私人信件均可使用。在 C# 中，開發人員經常需要以程式設計方式產生 Microsoft Word 文件。 Windows 應用程式開發人員歷來使用 Microsoft Office Interop 和 C# 產生和建立 Word 文件。

然而，這種方法並非人人適用，有些開發者使用的作業系統或 Linux 機器上可能沒有 Microsoft Office 介面。在這種情況下，開發人員必須探索其他可以在不同平台上獨立運作的程式庫。 IronWord是Iron Software出品的一個功能強大的庫，可用於以程式設計方式處理 Word 文件。

IronWord為在.NET應用程式中處理 Word 文件提供了強大的功能，並且可以在不同的平台和基於 Linux 的 docker 映像/容器上運行。 IronWord具有直覺的 C#、VB .NET Word 和 Docx 文件 API，無需安裝 Microsoft Office、Office 自動化或 Word Interop 即可建置、編輯和匯出 Word 文件檔案。 IronWord完全支援.NET 8、7、6、Framework、Core 和 Azure。

本文將探討如何使用IronWord函式庫在 C# 中建立 Word 文件。

How to Create Word Documents Without Office Interop in C

建立一個新的 C# 專案。
安裝IronWord庫。
使用IronWord庫建立 Word 文件。
在現有文件中新增內容。
儲存已建立的 Word 文件。
開啟並顯示已建立的 Word 文件。

先決條件：

Visual Studio：確保您已安裝 Visual Studio 或任何其他 C# 開發環境。
NuGet套件管理器：確保您可以使用NuGet管理專案中的套件。

步驟 1：建立一個新的 C# 項目

建立一個新的 C# 控制台應用程序，或使用一個現有的專案來產生 Word 文件。

選擇控制台應用程式模板，然後按一下下一步。

如何在不使用 Office Interop 的情況下以 C# 建立 Word 文件：圖 1 - 用於建立新專案的控制台應用程式範本

下一步，您可以提供解決方案名稱和專案名稱。

如何在不使用 Office Interop 的情況下以 C# 建立 Word 文件：圖 2 - 使用解決方案和專案名稱設定專案

選擇.NET版本，然後按一下"建立"。

如何在C#中建立不使用Office Interop的Word文件：圖3 - 使用正確的.NET版本建立專案

步驟 2：安裝IronWord函式庫

開啟您的 C# 項目，並使用NuGet套件管理器控制台安裝IronWord庫：

Install-Package IronWord -Version 2024.1.2

也可以使用 Visual Studio 套件管理器安裝NuGet套件，如下圖所示。

如何在不使用 Office Interop 的情況下以 C# 建立 Word 文件：圖 4 - 使用 VS 套件管理器安裝IronWord

步驟 3：使用IronWord庫建立並儲存 Word 文檔

讓我們從使用IronWord庫建立 Word 文件這個簡單的範例開始。以下程式碼示範如何建立一個包含單一段落的 Word 文檔，該段落的內容為"Hello, World!"

using IronWord;
using IronWord.Models;

// Create a text run instance with "Hello, World!" content
TextRun textRun = new TextRun("Hello, World!");

// Create a paragraph and add the text run to it
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Create a new Word document object with the paragraph
WordDocument doc = new WordDocument(paragraph);

// Save the document as a .docx file
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

using IronWord;
using IronWord.Models;

// Create a text run instance with "Hello, World!" content
TextRun textRun = new TextRun("Hello, World!");

// Create a paragraph and add the text run to it
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Create a new Word document object with the paragraph
WordDocument doc = new WordDocument(paragraph);

// Save the document as a .docx file
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

$vbLabelText $csharpLabel

執行上述程式碼範例後，將建立新文件檔案 example.docx，輸出如下所示。

如何在不使用 Office Interop 的情況下以 C# 建立 Word 文件：圖 5 - 透過上述程式碼建立的 Word 文件。

這是一個使用IronWord產生 Word 文件檔案的基本範例。如需了解更多信息，您可以閱讀文件。

在 Word 文件中新增帶有樣式的段落

現在我們已經知道如何使用IronWord建立簡單的 Word 文檔，接下來讓我們新增段落和樣式文字。

TextRun 還可以獲得樣式數據，增強文字的視覺效果。文字可以設定刪除線、粗體、斜體和底線等樣式。

修改以下程式碼並將其新增至您先前編寫的程式。

using IronWord;
using IronWord.Models;

// Create text runs with different styles
TextRun textRun = new TextRun("Hello, World!"); // Simple string
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Configure and add italic text
TextRun introText = new TextRun("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
TextRun italicText = new TextRun("Italic example sentence.", italicStyle);

// Configure and add bold text
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
TextRun boldText = new TextRun("Bold example sentence.", boldStyle);

// Add text runs to the paragraph
paragraph.AddTextRun(introText);
paragraph.AddTextRun(italicText);
paragraph.AddTextRun(boldText);

// Create and save the new Word document
WordDocument doc = new WordDocument(paragraph);
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

using IronWord;
using IronWord.Models;

// Create text runs with different styles
TextRun textRun = new TextRun("Hello, World!"); // Simple string
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Configure and add italic text
TextRun introText = new TextRun("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
TextRun italicText = new TextRun("Italic example sentence.", italicStyle);

// Configure and add bold text
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
TextRun boldText = new TextRun("Bold example sentence.", boldStyle);

// Add text runs to the paragraph
paragraph.AddTextRun(introText);
paragraph.AddTextRun(italicText);
paragraph.AddTextRun(boldText);

// Create and save the new Word document
WordDocument doc = new WordDocument(paragraph);
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

$vbLabelText $csharpLabel

在 Word 文件中新增表格

為了更清晰地呈現數據，也可以用網格的形式來表示。當資料以網格形式排列時，就稱為表格。使用IronWord，我們可以在 Word 文件中新增表格和圖像，如下所示：

using IronWord;
using IronWord.Models;

// Create a table cell with sample text
TableCell cell = new TableCell();
TextRun textRun = new TextRun("Sample text");

// Add text run to the cell as a paragraph
cell.AddContent(new Paragraph(textRun));

// Configure cell border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};

// Set table borders
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
cell.Borders = tableBorders;

// Create a table row and add cells to it
TableRow row = new TableRow();
row.AddCell(cell); // Add the first cell
row.AddCell(cell); // Add the second cell, duplicating to mimic a row with two identical cells

// Create a table and add the row to the table
Table table = new Table();
table.AddRow(row);

// Create and save a Word document using the table
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx"); // Saves the file to disk with the name Document.docx

using IronWord;
using IronWord.Models;

// Create a table cell with sample text
TableCell cell = new TableCell();
TextRun textRun = new TextRun("Sample text");

// Add text run to the cell as a paragraph
cell.AddContent(new Paragraph(textRun));

// Configure cell border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};

// Set table borders
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
cell.Borders = tableBorders;

// Create a table row and add cells to it
TableRow row = new TableRow();
row.AddCell(cell); // Add the first cell
row.AddCell(cell); // Add the second cell, duplicating to mimic a row with two identical cells

// Create a table and add the row to the table
Table table = new Table();
table.AddRow(row);

// Create and save a Word document using the table
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx"); // Saves the file to disk with the name Document.docx

$vbLabelText $csharpLabel

在上面的範例中，我們使用邊框向 Word 文件中新增了一個表格。

在 Word 文件中新增圖片

圖片可以增強文件的呈現效果，並增添更多色彩和視覺吸引力。

可以使用IronWord以程式設計方式將圖像新增至 Word 文件中，如下面的程式碼所示：

using IronWord;
using IronWord.Models;

// Load a new document
WordDocument doc = new WordDocument();

// Configure and add image to the document
IronWord.Models.Image image = new IronWord.Models.Image("SalesChart.jpg")
{
    Width = 200, // Set image width in pixels
    Height = 200 // Set image height in pixels
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image); // Add image to paragraph
doc.AddParagraph(paragraph); // Add paragraph to the document

// Save the document as a .docx file
doc.SaveAs("save_document.docx"); // Saves the file to disk with the name save_document.docx

using IronWord;
using IronWord.Models;

// Load a new document
WordDocument doc = new WordDocument();

// Configure and add image to the document
IronWord.Models.Image image = new IronWord.Models.Image("SalesChart.jpg")
{
    Width = 200, // Set image width in pixels
    Height = 200 // Set image height in pixels
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image); // Add image to paragraph
doc.AddParagraph(paragraph); // Add paragraph to the document

// Save the document as a .docx file
doc.SaveAs("save_document.docx"); // Saves the file to disk with the name save_document.docx

$vbLabelText $csharpLabel

在這裡，我們使用 IronWord.Models.Image 為段落中添加一個高度和寬度均為 200 像素的圖像。

授權許可(提供免費試用)

使用IronWord需要授權。從Iron Software網站取得試用金鑰。此密鑰需要放入 appsettings.json 中。

{
    "IronWord.LicenseKey": "IRONWORD.MYLICENSE.KEY.TRIAL"
}

請提供您的電子郵件地址以取得試用許可證。提交您的電子郵件地址後，金鑰將透過電子郵件發送給您。

如何在不使用 Office Interop 的情況下以 C# 建立 Word 文件：圖 6 - 成功提交試用表單後的彈出視窗

結論

使用IronWord庫在 C# 中建立 Word 文檔，無需依賴 Microsoft Office，即可靈活且有效率地產生文檔。無論您需要建立簡單的信函，還是包含表格和圖像的複雜報告， IronWord都能以程式設計方式幫助您輕鬆實現。本文提供了創建 Word 文件的全面教學。透過IronWord，您可以自動建立 Word 文檔，使您的 C# 應用程式更加靈活高效。

對於希望將 PDF 文件操作與生成的 Word 文件結合使用的開發人員來說， IronPDF是Iron Software開發的另一個 C# 庫，無需再尋找其他工具。

常見問題解答

如何在 C# 中不使用 Microsoft Office Interop 創建 Word 文件？

您可以通過使用 IronWORD 函式庫在 C# 中建立 Word 文件，而不需要使用 Microsoft Office Interop。此函式庫允許您以編程方式生成、編輯和儲存 Word 文件，而無需安裝 Microsoft Office。

使用 IronWORD 相較於 Microsoft Office Interop 的優勢有哪些？

IronWORD 提供在 Linux 等非 Windows 平台運行的靈活性，這些平台上無法使用 Microsoft Office Interop。它還消除了對 Microsoft Office 安裝的依賴，簡化了開發過程。

如何開始使用 IronWORD 建立 Word 文件？

要開始使用 IronWORD 建立 Word 文件，首先在您的 C# 專案中通過 NuGet 套件管理器安裝 IronWORD 函式庫。然後使用 IronWORD API 以編程方式建立和操縱 Word 文件。

我能在最新的 .NET 版本中使用 IronWORD 嗎？

是的，IronWORD 與各種 .NET 版本相容，包括 .NET 8 ，7，6，Framework，Core 和 Azure，允許您將其整合到現代 C# 應用程式中。

如何在使用 IronWORD 的 Word 文檔中添加樣式文本？

IronWORD 允許您使用 TextRun 和 TextStyle 類別添加樣式文本。這些類別允許您在 Word 文件中的特定文本段中應用加粗、斜體和下劃線等樣式。

使用 IronWORD 可以在 Word 文件中包含表格嗎？

是的，您可以使用 IronWORD 在 Word 文件中包含表格。該函式庫允許您定義具有行和單元格的表格，並且可以使用邊框和其他樣式客製化其外觀。

如何使用 IronWORD 在 Word 文件中插入圖片？

要使用 IronWORD 在 Word 文件中插入圖片，您可以使用 IronWord.Models.Image 類將具有指定尺寸的圖片嵌入到段落中，從而提升文件的視覺內容。

是否有 IronWORD 的試用版可供評估？

是的，Iron Software 提供了 IronWORD 的免費試用版，您可以從他們的網站下載。此試用版允許您在購買之前評估函式庫的功能和能力。

Iron Software 提供了哪些其他文件操作函式庫？

除了 IronWORD，Iron Software 還提供了 IronPDF，用於處理 PDF 文件的函式庫。這些函式庫共同為在 C# 應用程式中處理 Word 和 PDF 文件提供了全面的解決方案。

Jordi Bardia

立即與工程團隊聊天

軟體工程師

Jordi 在 Python、C# 和 C++ 上最得心應手，當他不在 Iron Software 展現技術時，便在做遊戲編程。在分担產品测测试，產品開發和研究的责任時，Jordi 為持续的產品改進增值。他说这种多样化的经验使他受到挑战并保持参与, 而这也是他与 Iron Software 中工作一大乐趣。Jordi 在佛罗里达州迈阿密长大，曾在佛罗里达大学学习计算机科学和统计学。