使用IRONWORD

.NET Word API（其工作原理）

發佈 2024年4月3日

介紹

這.NET Word API為開發人員提供強大的工具，以在其應用程式中轉換、互動和處理 MS Word 文件。此 API 專為簡化處理 Microsoft Word 文件的過程而設計，使得程式化地創建、編輯、轉換和管理文件變得更加容易。在本文中，我們將探討IronWord了解其操作 Word 文件的功能。

IronWord 簡介

IronWord是一個 .NET Word 庫，屬於 .NET Word API 生態系統，專為在其 .NET 應用程式中處理 Microsoft Word 文件的開發人員設計。使用 IronWord，開發者可以輕鬆地讀取、撰寫和修改 Word 文件，而無需在伺服器或客戶端機器上安裝 Microsoft Word。此功能對於需要自動化文檔處理任務的應用程式特別有利，例如通過郵件合併功能生成報告、發票或個性化信函。

IronWord 的功能

IronWord 提供廣泛的功能，涵蓋 Word 文件處理的各個方面。讓我們探索每組功能，重點是它們如何啟用多個文件的操作和合併，並根據「文件結構」和「文件元素」進行分類。

文件結構

读取和编辑 Word：使用 IronWord，您可以从您的 Word 文档中提取特定信息，例如提取文本以进行编辑或重新利用，以及检索可能需要在其他地方使用的图像。此功能對於旨在合併 Word 文檔和處理現有 DOCX 文件中信息的應用程式至關重要。

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

編輯頁面設置：使用IronWord，調整Word文件的物理佈局非常簡單。您可以調整各種 MS Word 文件的紙張大小為標準或自訂尺寸，變更文檔不同部分的方向，設置邊距以確保正確對齊，甚至可以修改背景顏色以達到美觀效果或突顯某些部分。

新增段落：IronWord 支援新增和移除文本在段落內運行，這對於編輯和格式化大型文本段落是必不可少的。此外，您可以通過將圖像和形狀直接插入到文本中來增強段落，調整樣式以符合您的設計規範，並設置對齊方式以達到精緻的外觀。添加項目符號和編號列表的功能也有助於更有效地組織內容。

using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Create and add styled text to a paragraph
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
// Add paragraph and export docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Create and add styled text to a paragraph
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
// Add paragraph and export docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
' Create and add styled text to a paragraph
Private paragraph As New Paragraph()
paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
' Add paragraph and export docx
doc.AddParagraph(paragraph)
doc.SaveAs("newdocument.docx")

VB C#

添加表格:表格是 DOCX 文件的關鍵組成部分，可以輕鬆地使用 IronWord 進行操作，支援動態文件生成。您可以新增或刪除列和欄，這是一個關鍵操作，用於動態文件生成，其中數據量可能會有所變化。合併和拆分儲存格讓您能夠靈活地格式化複雜的表格，並且自訂邊框和佈局尺寸可提供精緻、專業的外觀。

using IronWord;
using IronWord.Models;
// 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;
// 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");

Imports IronWord
Imports IronWord.Models
' Create a table cell with a paragraph containing text
Private cell As New TableCell(New Paragraph(New TextRun("Sample text")))
' Configure a common border style for the table
Private borderStyle As New BorderStyle With {
	.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 With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}
' Create a table row and add the same cell twice
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)
' Create a table, add the row, then create and export the Word document
Dim table As New Table()
table.AddRow(row)
Dim doc As New WordDocument(table)
doc.SaveAs("Document.docx")

VB C#

.NET Word API（開發者使用說明）：圖1 - 含有表格的輸出PDF

文件元素

新增 TextRuns：此功能主要用於對文字內容進行精細控制。您可以添加、附加和分割文字運行，這對於動態文件的創建至關重要。樣式選項非常廣泛，包括更改字體系列、大小和顏色，以及添加粗體、斜體和其他文字裝飾。您也可以在文本中嵌入圖像，創建一個豐富且具有視覺吸引力的文檔。

新增圖片：IronWord 提供全面的圖像處理在 Word 文件中。您可以從各種來源載入圖像，無縫地將文字環繞在圖像周圍，並調整其尺寸以適應您的版面配置。能夠設置位置偏移和與文件角落的距離，這意味著您的圖像將始終完美地放置。

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
Private image As New IronWord.Models.Image("your-image.jpg") With {
	.Width = 200,
	.Height = 200
}
Private paragraph, add, add, [and] As Create
paragraph.AddImage(image)
doc.AddParagraph(paragraph)
doc.SaveAs("save_document.docx")

VB C#

添加形狀：形狀可以為文件帶來顯著的視覺衝擊，而 IronWord 為您提供插入和精確自定義這些形狀的工具。您可以設置形狀類型(像矩形、圓形、箭頭等。), 確定文字應如何環繞形狀，指定精確的尺寸和定位，甚至旋轉形狀以達到所需的視覺效果。

相容性

.NET 版本與專案類型

.NET Word API（對開發者如何運作）：圖 2 - IronWord 相容的 .NET 版本和專案類型

IronWord 專為 .NET 生態系統中的廣泛相容性而設計，支援 C#、VB.NET 和 F#，適用於各種 .NET 版本，包括 .NET Core、.NET Standard 和 .NET Framework。這可確保其在當代和傳統應用中的實用性。該程式庫的多功能性延伸至各類專案類型，通過與Blazor、WebForms、Xamarin、MAUI、WPF和控制台應用程式的整合，適用於網頁、移動和桌面應用程式。