如何使用 C# 對齊 Word 中的文本

如何使用IronWord NuGet在 Microsoft Word 文件中對齊文本

1. 在 Microsoft Visual Studio 中建立一個新專案。
2. 透過NuGet套件管理器安裝IronWord 。
3. 產生一個文字對齊的 Word 文件。
4. 探索IronWord中的文字對齊屬性。

IronWord是什麼？

IronWord是Iron Software開發的一個 C# NuGet函式庫，旨在以程式設計方式簡化 Microsoft Word 檔案的建立、操作和管理。 它允許開發人員自動產生帶有對齊文字的 Word 文檔，從而更容易在其應用程式中動態產生報告、發票、信件和其他類型的文檔。

先決條件

開始之前，請務必準備好以下物品：

• 您的電腦上已安裝 Visual Studio。
• 已安裝最新版本的.NET Framework 。

步驟 1：在 Microsoft Visual Studio 中建立一個新項目

現在，讓我們從建立一個新的 Visual Studio 專案開始。

在下方畫面上選擇"控制台"應用程式範本。

請提供項目名稱和地點。

選擇.NET版本，最好選擇支援的最新版本，然後按一下"建立"。

步驟 2：使用NuGet套件管理器安裝IronWord

在 Visual Studio 中，請依照下列步驟從NuGet套件管理器安裝IronWord NuGet套件。

或者，請使用以下命令直接透過 CLI 安裝。

dotnet add package IronWord --version 2024.9.1

步驟 3：產生帶有文字對齊方式的 Word 文檔

下面的程式碼範例展示如何產生居中對齊文字的 Word 文件。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new document
        var document = new WordDocument();

        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // Add text to the paragraph

        // Set text alignment to center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;

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

        // Save the document with the specified filename
        document.SaveAs("output.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new document
        var document = new WordDocument();

        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // Add text to the paragraph

        // Set text alignment to center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;

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

        // Save the document with the specified filename
        document.SaveAs("output.docx");
    }
}

程式碼解釋

1. 初始化一個新的 WordDocument 實例。
2. 建立一個包含所需內容的文字物件。
3. 將文字加入段落。
4. 使用 IronWord.Models.Enums.TextAlignment.Center 對齊段落。
5. 將段落新增至 WordDocument 實例，並將文件儲存到 output.docx。

輸出

步驟 4：探索IronWord中的文字對齊屬性

現在我們來嘗試不同的方法。

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new DOCX document
        var doc = new WordDocument();

        // Sample text for alignment
        Text text = new Text() { Text = "IronWord, From IronSoftware" };

        // Add paragraphs with different alignments
        AddPara(doc, text, TextAlignment.Center);
        AddPara(doc, text, TextAlignment.Left);
        AddPara(doc, text, TextAlignment.Right);
        AddPara(doc, text, TextAlignment.Justified);

        // Save the document with all alignment options
        doc.SaveAs("outputAllOptions.docx");
    }

    // Method to add a paragraph to the document with specified alignment
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new DOCX document
        var doc = new WordDocument();

        // Sample text for alignment
        Text text = new Text() { Text = "IronWord, From IronSoftware" };

        // Add paragraphs with different alignments
        AddPara(doc, text, TextAlignment.Center);
        AddPara(doc, text, TextAlignment.Left);
        AddPara(doc, text, TextAlignment.Right);
        AddPara(doc, text, TextAlignment.Justified);

        // Save the document with all alignment options
        doc.SaveAs("outputAllOptions.docx");
    }

    // Method to add a paragraph to the document with specified alignment
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

程式碼解釋

1. 初始化一個新的 WordDocument 實例。
2. 建立一個包含所需內容的文字物件。
3. 對於每種對齊方式(居中、左對齊、右對齊、兩端對齊)，將文字新增至段落並設定對齊方式。
4. 將段落加入到 WordDocument 實例。
5. 將文件儲存為 outputAllOptions.docx，並保留所有對齊方式。

輸出

IronWord授權

IronWord庫是Iron Software的Iron Suite產品之一。 它需要許可證才能運行。 使用者可以使用自己的郵件地址從試用許可證頁面下載試用許可證。 資料輸入完畢後，許可證將發送到使用者的電子郵箱。 在使用IronWord函式庫之前，需要將此授權放在使用者程式碼的開頭，如下所示。

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

結論

IronWord NuGet套件簡化了在.NET應用程式中處理 Word 文件的過程。 其直覺的 API 使開發人員能夠輕鬆地操作文字對齊方式和其他文件元素。 無論您需要將文字左對齊、居中對齊、右對齊或兩端對齊， IronWord都能提供您創建專業且格式良好的文件所需的工具。