1. IronWord
  2. 開始使用

開始使用IronWord

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord：適用於 .NET 的 Word 文件庫

IronWord 是 Iron Software 開發的 Word 文檔庫。 IronWord 在 .NET 應用程式中處理 Word 文件提供了強大的功能。

  • 加載、操作和保存 Word 和 Docx 文檔。
  • 頁面設定：配置紙張大小、頁面方向、邊距和背景顏色。
  • TextRun：處理文本內容、樣式、分割、附加文本和添加圖片。
  • 字體樣式：管理字體家族、大小、顏色、粗體、斜體、刪除線、底線、上標和下標。
  • 段落：添加文字行、圖像、形狀、設定樣式、對齊、項目符號和編號列表。
  • 表格：操作表格結構，包括增加行、獲取和設置單元格值、刪除行、合併單元格等。
  • 圖片：從文件或流中加載圖片，設置文字繞排、位置偏移、寬度、高度和其他屬性。
  • 形状：设置文本环绕、位置偏移、宽度、高度、形状类型和旋转。

    .NET 的 Word 文件 C# 函式庫

    1. 下載處理 DOCX 文件的 C# 庫
    2. 創建和修改 Word 和 DOCX 文件
    3. 新增文件結構，例如段落、章節和表格。
    4. 添加文檔元素，例如文字串、圖像和形狀
    5. 輕鬆為文件元素設計樣式

安裝

IronWord 函式庫

安裝 IronWord 既快速又容易，請按照以下方式安裝套件：

Install-Package IronWord

或者，直接從官方 IronWord NuGet 網站.

安裝完成後，您可以通過在 C# 代碼頂部添加 using IronWord; 來開始使用。

套用授權金鑰

接著，通過將許可證密鑵分配給 License 類的 LicenseKey 屬性，來為 IronWord 應用有效的許可證或試用密鑵。 在導入語句之後和使用任何 IronWord 方法之前，請包含以下代碼：

:path=/static-assets/word/content-code-examples/get-started/get-started-license.cs
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01";
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01"
VB   C#

程式碼範例

由 IronWord 生成的 DOCX 文件在某些版本的 Microsoft Word 中打開可能會處於兼容模式，導致某些樣式無法使用。 要將 Word 文件轉換出兼容模式：

  1. 選擇「檔案」>「資訊」並點擊「轉換」。

  2. 您將收到一則訊息，通知您的文件將升級至最新的文件格式。 按一下「確定」。

創建 Word 和 Docx 文檔

使用其中一個構造函數實例化 WordDocument 類來創建 Word 文件。 之後，使用 SaveAs 方法來導出 Word 文檔。

:path=/static-assets/word/content-code-examples/get-started/get-started-1.cs
using IronWord;
using IronWord.Models;

// Create textrun
Text textRun = new Text("Sample text");

Paragraph paragraph = new Paragraph();
paragraph.AddText(textRun);

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

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Create textrun
Private textRun As New Text("Sample text")

Private paragraph As New Paragraph()
paragraph.AddText(textRun)

' Create a new Word document
Dim doc As New WordDocument(paragraph)

' Export docx
doc.SaveAs("document.docx")
VB   C#

添加圖片

影像本身無法添加； 相反，它應該被添加到文檔結構之一，如 Paragraph、TableCell 或 Section。 使用 AddImage 方法來添加圖片。

:path=/static-assets/word/content-code-examples/get-started/get-started-2.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure image
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 250; // In unit pixel
image.Height = 200; // In unit pixel
Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument("document.docx")

' Configure image
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 250 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
VB   C#

添加表格

要添加表格需要更多工作，因為必須創建表格、行、列和表格單元。 然而，使用這種設定，有重大的配置機會。 每個單元格可以有不同的樣式。 探索各種邊框樣式，提供多達24種選擇。

:path=/static-assets/word/content-code-examples/get-started/get-started-3.cs
using IronWord;
using IronWord.Models;

// Create table cell
TableCell cell = new TableCell();

Text textRun = new Text();
textRun.Text = "Sample text";

// Add textrun to the cell
cell.AddChild(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configure table border
TableBorders tableBorders = new TableBorders() {
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

cell.Borders = tableBorders;

// Create row and add cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

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

// Create new Word document from the table
WordDocument doc = new WordDocument(table);

// Export Word document
doc.SaveAs("Document.docx");
Imports IronWord
Imports IronWord.Models

' Create table cell
Private cell As New TableCell()

Private textRun As New Text()
textRun.Text = "Sample text"

' Add textrun to the cell
cell.AddChild(New Paragraph(textRun))

' Configure border style
Dim borderStyle As New BorderStyle()
borderStyle.BorderColor = Color.Black
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick
borderStyle.BorderSize = 5

' Configure table border
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

cell.Borders = tableBorders

' Create row and add cell
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)

' Create table and add row
Dim table As New Table()
table.AddRow(row)

' Create new Word document from the table
Dim doc As New WordDocument(table)

' Export Word document
doc.SaveAs("Document.docx")
VB   C#

授權與支持可用

IronWord 是一個付費的庫，但也提供免費試用授權。這裡.

有關 Iron Software 的更多資訊，請訪問我們的網站：https://ironsoftware.com/ 如需更多支援和查詢，請請詢問我們的團隊.

來自 Iron Software 的支援

如需一般支援和技術查詢，請透過以下電子郵件與我們聯絡：support@ironsoftware.com