.NET Word API（開發者使用指南）

文檔結構

讀取和編輯 Word：使用 IronWord，您可以從 Word 文件中提取特定訊息，例如提取文字進行編輯或重新利用，以及擷取可能需要在其他地方使用的圖像。 對於旨在合併 Word 文件和處理現有 DOCX 文件中包含的資訊的應用程式而言，此功能至關重要。

多種格式： IronWord 支援多種文件格式，增強了其在 .NET 應用程式中轉換 Word 文件的實用性。

編輯頁面設定：使用 IronWord 可以輕鬆自訂 Word 文件的實體佈局。 您可以調整各種 MS Word 文件的紙張尺寸為標準尺寸或自訂尺寸，更改文件不同部分的方向，設定頁邊距以確保正確對齊，甚至可以出於美觀目的或突出顯示部分內容而修改背景顏色。

新增段落： IronWord 允許在段落中新增和刪除文字行，這對於編輯和格式化大段文字至關重要。 此外，您還可以透過在文字中直接插入圖像和形狀來增強段落，調整樣式以匹配您的設計規範，並設定對齊方式以獲得更精緻的外觀。 新增項目符號和編號清單的功能也有助於更有效地組織內容。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

新增表格：表格是 DOCX 檔案的重要組成部分，使用 IronWord 可以輕鬆操作表格，支援動態文件產生。 您可以新增或刪除行和列，這對於資料量可能變化的動態文件產生至關重要。 合併和分割單元格使您能夠靈活地格式化複雜的表格，而自訂邊框和佈局尺寸則可以打造精緻、專業的外觀。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

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

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));

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

        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };

        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);

        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

! .NET Word API（開發者使用指南）：圖 1 - 包含表格的輸出 PDF

文檔元素

新增文字運作：此功能著重於對文字內容進行精細控制。 您可以新增、追加和分割文本，這對於動態建立文件至關重要。 樣式選項非常豐富，包括更改字體系列、大小和顏色，以及添加粗體、斜體和其他文字裝飾。 您也可以將圖像嵌入文字中，從而創建內容豐富、視覺效果引人入勝的文件。

新增圖片： IronWord 允許在 Word 文件中進行全面的影像處理。 您可以從各種來源載入圖像，使文字無縫環繞圖像，並調整圖像尺寸以適應您的佈局。 透過設定位置偏移量和與文件邊角的距離，可以確保您的影像始終完美放置。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

新增形狀：形狀可以為文件增添顯著的視覺效果，IronWord 為您提供了精確插入和自訂形狀的工具。 您可以設定形狀類型（如矩形、圓形、箭頭等），確定文字應如何環繞形狀，指定精確的尺寸和位置，甚至旋轉形狀以達到所需的視覺效果。

.NET 版本和專案類型

! .NET Word API（開發者使用指南）：圖 2 - IronWord 相容的 .NET 版本和專案類型

IronWord 旨在與 .NET 生態系統廣泛相容，支援各種 .NET 版本（包括 .NET Core、.NET Standard 和 .NET Framework）上的 C#、VB.NET 和 F#。 這確保了它在現代應用和傳統應用中的實用性。 該程式庫的多功能性也體現在專案類型上，透過與 Blazor、WebForms、Xamarin、MAUI、WPF 和控制台應用程式的集成，可滿足 Web、行動和桌面應用程式的需求。

應用環境

! .NET Word API（開發者使用方法）：圖 3 - IronWord 可運行的應用程式環境

在應用環境方面，IronWord 可適應 Windows、Linux、iOS 和 Android 平台，包括對容器化和在 Docker、Azure 和 AWS 上進行雲端部署的特定支援。 這種廣泛的支持有助於在不同環境下的發展。

作業系統和整合開發環境

! .NET Word API（開發者使用方法）：圖 4 - 作業系統與 IDE 的 IronWord 與

IronWord 也相容於主流的整合開發環境 (IDE)，例如 Microsoft Visual Studio、ReSharper 和 Rider，為開發人員提供了選擇工具的靈活性。 最後，它支援各種作業系統和處理器架構（x64、x86、ARM），確保在各種硬體配置下都能高效運作。

精簡版許可證

此選項專為單獨開發專案的個人開發人員量身定制。 它的定價為$799 ，適用於單一地點的單一開發者。

Plus 許可證

此許可證面向小型團隊，售價為 $plusLicense，最多可供三名開發人員使用，並適用於三個地點的三個項目。

專業執照

對於規模較大的團隊，專業授權的價格為 $professionalLicense，最多可支援十名開發人員。 它旨在滿足更大規模的操作需求，並包含高級支援功能。