C# Document Element Tutorial

Q: Wordドキュメントでテキストを分割する方法は何ですか？

IronWordは Split メソッドを提供しており、指定されたデリミタに基づいてテキストランをより小さなセグメントに分割し、テキスト操作を容易にします。

Updated: 2026年5月9日

IronWordは.NET C#開発者がアプリケーションにWordおよびDOCXドキュメントの作成、読み取り、編集機能を統合する助けとなる強力なWordドキュメントライブラリです。 Wordドキュメントのコンテキストでは、ドキュメントエレメントとはコンテンツを構成する要素です。

クイックスタート: スタイル付き TextRun を作成し、画像を埋め込む

ここでは、 IronWord を使用して、スタイル設定されたテキストとドキュメントの埋め込み画像を組み合わせてリッチコンテンツを追加する方法について説明します。この例は、スタイル付きテキストのためのRunラッパーパターンを示しています。

1Install IronWord with NuGet Package Manager
PM > Install-Package IronWord
```
Install-Package IronWord
```

2このコードスニペットをコピーして実行します。

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Create styled Run
Run textRun = new Run(new TextContent("Hello IronWord!"));
textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue };

// Create paragraph and add Run
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
paragraph.AddImage(new ImageContent("pic.png"));

// Add to document and save
doc.AddParagraph(paragraph);
doc.SaveAs("output.docx");

using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Create styled Run
Run textRun = new Run(new TextContent("Hello IronWord!"));
textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue };

// Create paragraph and add Run
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
paragraph.AddImage(new ImageContent("pic.png"));

// Add to document and save
doc.AddParagraph(paragraph);
doc.SaveAs("output.docx");

3実際の環境でテストするためにデプロイする

今日プロジェクトで IronWord を使い始めましょう無料トライアル

テキストを追加
テキストコンテンツ (追加、付加 & 分割)
スタイリング設定 (フォントファミリー & サイズ、色、太字 & 斜体、取り消し線、下線、上付き文字 & 下付き文字)
画像を埋め込む
画像を追加
画像を読み込む (ファイル & FileStream)
テキストの折り返しを設定
寸法を設定 (幅 & 高さ)
位置オフセットを設定
角からの距離を設定

主要概念

ドキュメント階層

IronWordは、Document → Paragraph → Run → TextContentという構造化された文書階層に従います。この階層を理解することは、スタイル設定されたテキストを操作する上で不可欠です。

WordDocument: 文書全体を表す最上位コンテナ
Paragraph: 文書内のコンテンツのブロック
Run: TextContentを含み、スタイリングを適用できるラッパーオブジェクト
TextContent: 実際のテキスト文字列

段落にコンテンツを追加する

IronWord、段落にコンテンツを追加するための 2 つの方法が用意されています。

AddText(TextContent): スタイルなしのプレーンテキストに使用します。段落にTextContentを直接追加します。
AddChild(Run): スタイル付きテキストに使用します。段落にTextContentをラップし、スタイリングを保持する）を追加します。

フォントサイズや色、太字の書式設定などのスタイリングを適用する必要がある場合、AddChildを使って段落に追加してください。

TextRunsを追加

テキストコンテンツ

Splitメソッドは、指定された区切り文字に基づいてテキストランをより小さなテキストランのリストに分割するために利用されます。これにより、ドキュメント内のテキスト情報の編成と操作が可能です。

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));

// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

// Export docx
doc.SaveAs("textrun.docx");

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));

// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

// Export docx
doc.SaveAs("textrun.docx");

Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))

' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

' Export docx
doc.SaveAs("textrun.docx")

Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))

' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

' Export docx
doc.SaveAs("textrun.docx")

スタイリング設定

テキストのスタイリングを設定するには、Runラッパーパターンを使用する必要があります。 TextContentではなく）。 FontSize、色、太字、斜体、取り消し線、下線、上付き文字、下付き文字などの視覚的属性を定義することができます。

TextFontプロパティ内に設定されることに注意してください。スタイルが設定されたら、Runを段落に追加します。これは文書階層Document → Paragraph → Run → TextContentに従います。

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

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

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
    FontSize = 72,
    TextFont = new Font()
    {
        FontFamily = "Caveat"
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

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

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

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
    FontSize = 72,
    TextFont = new Font()
    {
        FontFamily = "Caveat"
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

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

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

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")

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

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

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")

テキストの塗りつぶし色を取得

スタイリングを設定することに加えて、IronWordは既存の文書からRGBA色値を取得して、スタイリング全体で一貫性を保つ方法を提供します。

using IronWord;
using IronWord.Models;
using System;

// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");

TextContent content = doc.Texts[0];

// This will show the R G B A of the themecolor
var filledColor = content.Color;

// Print the filled color variable to the console
Console.WriteLine(filledColor);

using IronWord;
using IronWord.Models;
using System;

// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");

TextContent content = doc.Texts[0];

// This will show the R G B A of the themecolor
var filledColor = content.Color;

// Print the filled color variable to the console
Console.WriteLine(filledColor);

色の値を取得するには、TextContentオブジェクトを取得します。 RGBA値を返し、文書全体で一貫したスタイリングを保つことができます。

画像を埋め込む

この機能により、コンテンツ内に画像をシームレスに含めることができ、文書の視覚的な魅力とコミュニケーション能力を高めます。

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();

// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

// Add paragraph
doc.AddParagraph(para);

// Export docx
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();

// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

// Add paragraph
doc.AddParagraph(para);

// Export docx
doc.SaveAs("save_document.docx");

画像を追加

画像を読み込む

画像を読み込むことは重要なプロセスです。これは、外部画像ファイルをドキュメントに取り込むことを含みます。画像を読み込む能力により、関連するビジュアルを含め、より魅力的で情報豊富なドキュメントに貢献します。

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage("image.jpg");

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage("image.jpg");

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

' Add image
paragraph.AddImage("image.jpg")

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")

Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

' Add image
paragraph.AddImage("image.jpg")

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")

画像を設定する

設定により画像を最適化します。これには、テキストの折り返し、寸法、位置、角からの距離といったプロパティの設定が含まれます。適切な設定により、画像が視覚的に心地よく、文脈に適した方法で表示されます。

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

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

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

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

よくある質問

C#でWord文書にテキストを追加するにはどうすればよいですか？

IronWordを使用して、テキストランのインスタンスを作成し、そこにテキストを追加してドキュメント内の段落に付加できます。

Wordドキュメントでテキストを分割する方法は何ですか？

IronWordはSplitメソッドを提供しており、指定されたデリミタに基づいてテキストランをより小さなセグメントに分割し、テキスト操作を容易にします。

IronWordを使用してWordドキュメントでテキストをスタイルするにはどうすればよいですか？

IronWordを使用すると、フォントサイズや色などの属性を設定し、太字、斜体、取り消し線、下線、上付き文字、下付き文字などのスタイルを適用してテキストをスタイルできます。

C#でWordドキュメントに画像を埋め込むにはどうすればよいですか？

IronWordを使用してWordドキュメントに画像を埋め込むには、ファイルから画像を読み込み、ドキュメント内の段落にインライン画像として追加できます。

Wordドキュメントに画像を読み込む手順は？

IronWordを使用すると、ファイルまたはファイルストリームから画像を読み込み、Wordドキュメントに視覚コンテンツを組み込むことができます。

Wordドキュメントで画像のプロパティを構成するにはどうすればよいですか？

IronWordを使用して、テキストの折り返し、寸法、位置オフセット、角からの距離などの画像プロパティを構成し、ドキュメント内で画像を適切に表示することができます。

Word ドキュメント内のテキストの RGBA カラー値を取得できますか？

はい、IronWordを使用すると、ドキュメント内の既存テキストのRGBAカラーバリューを取得でき、一貫したスタイルを維持できます。

Wordドキュメントを操作するためにIronWordの使用を開始するにはどうすればよいですか？

IronWordを使用するために、.NET C#アプリケーションに統合し、その包括的なライブラリ機能を活用してWordドキュメントを作成、読み取り、編集できます。

How do you save a Word document created with IronWord?

A Word document created with IronWord can be saved using the 'SaveAs' method, specifying the filename and path for saving the document.

What is the function of the 'AddParagraph' method in IronWord?

The 'AddParagraph' method in IronWord is used to add fully configured paragraphs, with text and images, to a Word document.

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...

詳しく読む