跳至頁尾內容
使用 IRONWORD

VS 2022 如何使用程式設計方式建立新的 Word 文件(教學)

在數位時代,文件正日益數位化。 在商業環境中,文件通常與微軟 Word 及其文件型 Word 文件相關聯。撰寫和編輯微軟 Word文件已成為大型組織中訊息傳遞的基礎。 然而,手動建立和編輯文件可能是一個痛苦的過程; 以程式設計方式自動產生 Word 文件也不是一件容易的事,因為許多開源程式庫都依賴 Microsoft Office Word。

然而,管理和建立 Word 文件並不一定非得這麼難。 IronWord是一個 C# Word 函式庫,它不依賴 Microsoft Office Word,允許使用者自訂整個文檔,同時也允許以程式設計方式產生文件和建立文件範本。

在今天的教程中,我將簡單解釋如何使用 IronWord 程式化創建 Microsoft Word 文檔,並提供簡單範例。

IronWord:AC# 字庫

IronWord 是一款極其可靠且使用者友好的 C# Docx 程式庫,它使開發人員能夠使用 C# 建立和修改 Word 文檔,而無需依賴 Microsoft Office 或 Word Interop 等傳統程式庫。此外,它擁有豐富的文檔,並全面支援 .NET 8、7、6、.NET Framework、.NET Core 和 Azure,使其與大多數應用程式具有廣泛的兼容性。 這種靈活性使其成為您可能遇到的任何應用的絕佳選擇。

建立環境

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

首先,我們建立一個新的控制台應用程式。

然後,提供項目名稱並儲存位置,如下所示。

最後,選擇所需的框架。

安裝 C# Word 庫

建立空白控制台應用程式後,我們將透過 NuGet 套件管理器下載IronWord

點擊"管理 NuGet 套件",然後在"瀏覽"標籤中搜尋 IronWord,如下所示。

之後,將其安裝到新建立的專案中。

或者,您也可以在命令列中輸入以下命令來安裝 IronWord。

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";
$vbLabelText   $csharpLabel

收到試用金鑰後,請在項目中設定此變數。

建立新的 Word 文檔

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

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

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}
$vbLabelText   $csharpLabel

! VS 2022 以程式設計方式建立新 Word 文件(教學):圖 6 - 上述範例的輸出

說明

  1. 首先,我們在範例程式碼中導入 IronWord 函式庫及其模型。
  2. 我們建立一個新的Text變數。 此變數允許我們在 Word 文件中新增文字。
  3. 然後我們將textRun加入到Paragraph 。 這樣我們就可以透過區分兩者來輕鬆處理文字。
  4. 我們將paragraph參數傳遞給一個新的WordDocument類,以建立一個新的文檔物件。
  5. 最後,我們將文件儲存為 Word 文件"document.docx"。

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

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

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

        // Create sample texts with styles
        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;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

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

        // Create sample texts with styles
        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;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}
$vbLabelText   $csharpLabel

! VS 2022 以程式設計方式建立新 Word 文件(教學):圖 7 - 上述範例程式碼的輸出

程式碼解釋

  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 文件。

結論

! VS 2022 以程式設計方式建立新 Word 文件(教學):圖 8 - IronWord 授權資訊

我們的示範表明,使用IronWord庫以 C# 程式設計方式建立 Word 文件是多麼容易。 該程式庫的靈活性和可擴展性使其成為開發人員在實際場景中(例如在 Word 文件中自訂文字、字體和樣式)的寶貴工具。 了解 Word 如何與其他應用程式集成,可以為開發人員提供更多應對挑戰的解決方案。

IronWord 提供免費試用授權

常見問題解答

如何使用 C# 以程式設計方式建立 Microsoft Word 文件?

您可以使用 IronWord 程式庫在 C# 中以程式設計方式建立 Microsoft Word 文件。初始化一個WordDocument對象,加入必要的內容,然後使用SaveAs方法將其匯出為 .docx 檔案。

與使用 Microsoft Office Interop 建立 Word 文件相比,使用 IronWord 有哪些優點?

IronWord 相較於 Microsoft Office Interop 具有諸多優勢,例如無需安裝 Microsoft Office,即可在不同平台上提供更大的靈活性和更便捷的集成,而無需依賴 Office。

如何在 Visual Studio 中安裝 IronWord?

若要在 Visual Studio 中安裝 IronWord,請開啟 NuGet 套件管理器,搜尋 IronWord,然後將其安裝到您的專案中。或者,您也可以使用命令列工具Install-Package IronWord

我可以使用 IronWord 對 Word 文件中的文字進行格式化嗎?

是的,您可以使用 IronWord 透過TextStyle物件對 Word 文件中的文字進行格式化,將各種樣式(如斜體和粗體)套用至文字元素。

IronWord 與 .NET 和 Azure 相容嗎?

是的,IronWord 與 .NET 8、7、6、Framework、Core 和 Azure 完全相容,使其適用於各種應用程式。

如何排除 IronWord 的安裝問題?

如果IronWord安裝過程中遇到問題,請確保您使用的是相容版本的Visual Studio和.NET,並且您的NuGet套件管理器已更新。檢查您的網路連線並重試安裝。

使用 IronWord 建立 Word 文件需要哪些條件?

若要開始使用 IronWord 建立 Word 文檔,請將 IronWord 庫及其模型匯入到您的 C# 專案中。然後,初始化一個WordDocument物件以開始建構文件。

如何使用 IronWord 以程式設計方式在 Word 文件中新增段落?

您可以使用 IronWord 以程式設計方式為 Word 文件新增段落,方法是建立Paragraph對象,向其中新增文本,然後將其包含在WordDocument中。

柯蒂斯·週
技術撰稿人

Curtis Chau擁有卡爾頓大學電腦科學學士學位,專長於前端開發,精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面,喜歡使用現代框架,並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

除了開發工作之外,柯蒂斯對物聯網 (IoT) 也抱有濃厚的興趣,致力於探索硬體和軟體整合的創新方法。閒暇時,他喜歡玩遊戲和製作 Discord 機器人,將他對科技的熱愛與創造力結合。