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を使用して、豊富なコンテンツを迅速に追加する方法です - 顧客スタイルのテキストと埋め込まれた画像を1つの段落で組み合わせ、ドキュメントを1つの流暢なコードブロックで保存します。 テンプレートなしで即座に開始したい開発者に最適です。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronWord with NuGet Package Manager

    PM > Install-Package IronWord

  2. Copy and run this code snippet.

    new WordDocument()
      .AddParagraph(new Paragraph(new TextContent("Hello IronWord!")).AddImage(new ImageContent("pic.png")))
      .SaveAs("output.docx");
  3. Deploy to test on your live environment

    Start using IronWord in your project today with a free trial
    arrow pointer

目次

TextRunsを追加

テキストコンテンツ

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

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

スタイリング設定

TextRunsのスタイリングを設定することで、テキストの視覚的表現を定義できます。 これには、フォントサイズ、色、スタイル、取り消し線、下線、上付き文字、下付き文字などの属性の指定が含まれます。 スタイリングの設定は、ドキュメントのテキストの全体的な見栄えを向上させます。

: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
TextContent textRun = new TextContent();
textRun.Text = "Add text using IronWord";
textRun.Style = new TextStyle()
{
    TextFont = new Font()
    {
        FontFamily = "Caveat",
        FontSize = 72,
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddText(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

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

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

Dim paragraph As New Paragraph()

' Add text
paragraph.AddText(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.FillColor;

// Print the filled color variable to the console
Console.WriteLine(filledColor);
Imports IronWord
Imports IronWord.Models
Imports System

' Open existing Word
Private doc As New WordDocument("Accent1TextThemcolor.docx")

Private content As TextContent = doc.Paragraphs(0).Texts(0)

' This will show the R G B A of the themecolor
Private filledColor = content.FillColor

' Print the filled color variable to the console
Console.WriteLine(filledColor)
$vbLabelText   $csharpLabel

まず、新しいWordDocumentを初期化してドキュメントをインポートし、次にParagraphs配列とTexts配列にアクセスしてTextプロパティを取得します。 Text クラスは、その後、既存のテキスト色のRGBA値を示すためにFillColorを返します。

画像を埋め込む

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

: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");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

' Configure image
Private image As New ImageContent("image.jpg")
image.Width = 200 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim textRun As New TextContent()

' Add image
Dim para As 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");
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")
$vbLabelText   $csharpLabel

画像を設定

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

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

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

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.WrapText = WrapText.Square;
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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Private doc As New WordDocument()

' Configure image
Private image As New ImageContent("image.jpg")
image.WrapText = WrapText.Square
image.Width = 100
image.Height = 100
image.DistanceFromTop = 50

Dim position = New ElementPosition()
position.X = 50
position.Y = 50
image.Position = position

Dim paragraph As 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
テクニカルライター

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

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

準備はいいですか?
Nuget ダウンロード 25,807 | バージョン: 2025.11 ただ今リリースされました