C#を使用してワードでテキストを整列する方法

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 フレームワークがインストールされている。

ステップ 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");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Set your license key for IronWord
		License.LicenseKey = "your key"

		' Create a new document
		Dim document = New WordDocument()

		' Create a paragraph and add text
		Dim paragraph As New Paragraph()
		Dim text As New Text() With {.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")
	End Sub
End Class

コードの説明

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);
    }
}

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

Friend Class Program
	Shared Sub Main()
		' Set your license key for IronWord
		License.LicenseKey = "your key"

		' Create a new DOCX document
		Dim doc = New WordDocument()

		' Sample text for alignment
		Dim text As New Text() With {.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")
	End Sub

	' Method to add a paragraph to the document with specified alignment
	Private Shared Sub AddPara(ByVal doc As WordDocument, ByVal text As Text, ByVal alignment As TextAlignment)
		Dim paragraph As New Paragraph()
		paragraph.AddText(text)
		paragraph.Alignment = alignment
		doc.AddParagraph(paragraph)
	End Sub
End Class

コードの説明

1. 新しいWordDocument インスタンスを初期化します。
2. 希望するコンテンツでテキストオブジェクトを作成します。
3. 各配置オプション（中央、左、右、両端揃え）ごとにテキストを段落に追加し、配置を設定します。
4. 段落をWordDocument インスタンスに追加します。
5. すべての配置オプションでドキュメントをoutputAllOptions.docxに保存します。

出力

IronWord ライセンス

IronWord ライブラリは、Iron Software の Iron Suite の製品の一つです。 実行にはライセンスが必要です。 ユーザーは、試用ライセンスページから自分のメール ID を使用して試用ライセンスをダウンロードできます。 データを入力すると、ライセンスはユーザーのメール ID に配信されます。 このライセンスは、IronWord ライブラリを使用する前に、ユーザーコードの先頭に配置する必要があります。

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here"

結論

IronWord NuGet パッケージは、.NET アプリケーションでの Word ドキュメント作業を簡素化します。 その直感的な API により、開発者はテキスト配置やその他のドキュメント要素を簡単に操作できます。 左、中央、右のいずれかにテキストを配置するか、それを両端揃えにする必要がある場合でも、IronWord はプロフェッショナルで整ったドキュメントを作成するために必要なツールを提供します。