1. IronWord
  2. チュートリアル
  3. ドキュメント要素
C#で文書要素を操作する方法

C# Document Element Tutorial

カーティス・チャウ
カーティス・チャウ
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

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

  1. IronWord をNuGetパッケージマネージャでインストール

    PM > 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");

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

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

    arrow pointer

目次

主要概念

ドキュメント階層

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

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

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

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

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

フォント サイズ、色、太字などのスタイルを適用する必要がある場合は、Run オブジェクトを作成し、TextStyle を Run に割り当て、AddChild を使用して段落に追加します。

TextRunsを追加

テキストコンテンツ

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

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs
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");
$vbLabelText   $csharpLabel

スタイリング設定

テキストのスタイルを設定するには、Run ラッパー パターンを使用する必要があります。 TextContent を含む Run オブジェクトを作成し、TextStyle を Run (TextContent ではありません) に割り当てます。 TextStyle を使用すると、FontSize、色、太字、斜体、取り消し線、下線、上付き文字、下付き文字などの視覚属性を定義できます。

FontSize は TextStyle レベルで構成されますが、FontFamily は TextFont プロパティ内で設定されることに注意してください。 スタイルを設定したら、AddChild を使用して段落に Run を追加します。 これは、ドキュメント階層に従います: ドキュメント → 段落 → 実行 → TextContent。

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs
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");
$vbLabelText   $csharpLabel

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

スタイルの設定以外に、 IronWord、既存のドキュメントから RGBA カラー値を取得して、スタイル全体の一貫性を維持する方法も提供しています。

:path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs
using IronWord;
using IronWord.Models;
using System;

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

TextContent content = doc.Paragraphs[0].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);
$vbLabelText   $csharpLabel

色の値を取得するには、WordDocument を使用してドキュメントをロードし、Paragraphs コレクションと Texts 配列にアクセスして、TextContent オブジェクトを取得します。 TextContent の Color プロパティは、テキストの既存の色の RGBA 値を返すため、ドキュメント全体で一貫したスタイルを維持できます。

画像を埋め込む

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

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs
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(new Paragraph(textRun));

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

画像を追加

画像を読み込む

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

:path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs
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");
$vbLabelText   $csharpLabel

画像を設定する

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

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
using IronSoftware.Abstractions.Word;

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

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.TextWrapBehavior = new TextWrapSquare();
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");
$vbLabelText   $csharpLabel

よくある質問

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ドキュメントを作成、読み取り、編集できます。

カーティス・チャウ
カーティス・チャウ
  今すぐエンジニアリングチームとチャット
テクニカルライター

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

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？
Nuget ダウンロード 35,581 | バージョン: 2026.3 リリース
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronWord
サンプルを実行する あなたのデータが Word ドキュメントになるのを見る。