VS 2022 程式化建立新的 Word 文件（教程）

在數位時代，文檔越來越數位化。 在商業環境中，文檔通常與 Microsoft Word 及其基於文檔的 Word 文件相關聯。撰寫和編輯Microsoft Word文件已成為大型組織中傳遞資訊的基礎。 然而，手動創建和編輯文件可能是一個痛苦的過程； 要程式化自動化生成 Word 文件也不是一件容易的事，因為許多開源函式庫依賴於 Microsoft Office Word 作為依賴項。

然而，管理和製作 Word 文件不需要如此困難。 IronWord是一個 C# Word 函式庫，不依賴於 Microsoft Office Word，允許用戶自定義整個文件，並且可以程式化地生成文件和創建文件模板。

在今天的教程中，我將簡要說明如何使用 IronWord 以編程方式創建 Microsoft Word 文件，並提供簡單的示例。

IronWord：一個 C# Word 庫

損壞的圖片 從Pixabay添加，從你的文件中選擇或拖放圖片到這裡。

IronWord是一個非常可靠且易於使用的C# Docx函式庫，它使開發者能夠使用C構建和修改Word文檔，且不需依賴傳統的依賴項，如Microsoft Office或Word Interlope。 此外，它擁有詳盡的文件並提供對 .NET 8、7、6、Framework、Core 和 Azure 的全面支援，使其能夠與大多數應用程式通用相容。 這種靈活性使其成為您可能正在使用的任何應用程式的理想選擇。

設定環境

在此範例中，我們將使用建立一個主控台應用程式Visual Studio展示如何使用IronWord庫創建空白Word文檔並對其進行操作。 在進行下一步之前，請確保您已安裝 Visual Studio。

首先，讓我們創建一個新的主控台應用程式。

損壞的圖片 從Pixabay添加，從你的文件中選擇或拖放圖片到這裡。

然後，提供專案名稱並儲存位置，如下所示。

損壞的圖片 從Pixabay添加，從你的文件中選擇或拖放圖片到這裡。

最後，選擇所需的框架。

損壞的圖片 從Pixabay添加，從你的文件中選擇或拖放圖片到這裡。

安裝 C# Word 庫

建立空白主控台應用程式後，我們將下載IronWord透過NuGet包管理器。

點擊「管理 NuGet 套件」，然後在「瀏覽標籤」中搜索 IronWord，如下所示。

損壞的圖片 從Pixabay添加，從你的文件中選擇或拖放圖片到這裡。

然後將其安裝到新創建的專案中。

或者，您可以在命令行中輸入以下命令來安裝IronWord。

Install-Package IronWord

Install-Package IronWord

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronWord

現在一切都準備就緒，我們來看看建立 Word 文件的範例。

授權金鑰

請記住，IronWord 需要授權金鑰才能運行。 您可以通過造訪這個獲取免費試用的金鑰連結.

//Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

//Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

收到試用金鑰後，將此變數設置在您的專案中。

建立新的 Word 文件

using IronWord;
using IronWord.Models;
// Create textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");

using IronWord;
using IronWord.Models;
// Create textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(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.AddChild(textRun)
' Create a new Word document
Dim doc As New WordDocument(paragraph)
' Export docx
doc.SaveAs("document.docx")

解釋

1. 首先，在範例程式碼中導入IronWord庫及其模型。

2. 接下來我們創建一個新的 "Text" 變量。 此變數允許我們將文字添加到 Word 文件中。

3. 接著，我們將「文本」添加到「段落」。這允許我們輕鬆地操作文本，因為可以區分這兩者。

4. 然後，我們將 "paragraph" 參數傳遞給新的 "WordDocument" 類以創建一個新的文檔對象。

5. 最後，我們將文件保存為 Word 文件 "document.docx"。

   在前面的示例中，我們創建了一個包含基本文字的 Word 文件。 讓我們來做一個例子，使用更高級的功能，例如自訂文字和添加文字效果。

using IronWord;
using IronWord.Models;
#region
IronWord.License.LicenseKey = "YOUR-KEY";
#endregion
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
Text introText = new Text("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
Text italicText = new Text("Italic example sentence.");
italicText.Style = italicStyle;
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
Text boldText = new Text("Bold example sentence.");
boldText.Style = boldStyle;
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
#region
IronWord.License.LicenseKey = "YOUR-KEY";
#endregion
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
Text introText = new Text("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
Text italicText = new Text("Italic example sentence.");
italicText.Style = italicStyle;
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
Text boldText = new Text("Bold example sentence.");
boldText.Style = boldStyle;
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
#Region ""
IronWord.License.LicenseKey = "YOUR-KEY"
'#End Region
' Load docx
Dim doc As New WordDocument("document.docx")
' Configure text
Dim introText As New Text("This is an example paragraph with italic and bold styling.")
Dim italicStyle As New TextStyle() With {.IsItalic = True}
Dim italicText As New Text("Italic example sentence.")
italicText.Style = italicStyle
Dim boldStyle As New TextStyle() With {.IsBold = True}
Dim boldText As New Text("Bold example sentence.")
boldText.Style = boldStyle
Dim paragraph As New Paragraph()
' Add text
paragraph.AddText(introText)
paragraph.AddText(italicText)
paragraph.AddText(boldText)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")

代碼說明

1. 如上述範例所示，我們創建 "Text" 對象並添加文件的範例文本。

2. 接著，我們創建一個新的 "TextStyle" 物件，並將屬性 "IsItalic" 設為 true，表示文字應為斜體。

3. 我們也對「boldText」變數這樣做，將屬性「IsBold」設為 true。

4. 接著，我們將「TextStyle」變數賦值給其各自的「Text」變數。

5. 接著我們建立一個「Paragraph」變數，並呼叫「AddText」方法來新增斜體和粗體文字。

6. 我們最終使用 "AddParagraph" 方法將段落新增到文件中。

7. 然後將文件儲存為 "save_document.docx"

   上面的範例展示了開發人員在使用 IronWord 時可以使用的字體和樣式，除了斜體和粗體文字效果外。 IronWord 還提供其他功能，以確保開發人員在所有情況下都有創建獨特 Word 文件的所有選項。

結論

我們的演示展示了使用此工具是多麼容易IronWord在 C# 中以程式方式建立 Word 文件的函式庫。 該程式庫的靈活性和可擴展性使其成為開發人員在現實場景中的寶貴工具，例如在 Word 文件中自定義文本、字體和樣式。 了解 Word 如何與其他應用程式整合，可為開發者提供更多解決其挑戰的方案。

IronWord 提供一個免費試用授權.