1. IronWord
  2. ハウツー
  3. 画像を追加

C#でDOCXに画像を追加する方法

Ahmad Sohail
Ahmad Sohail
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

画像は、既存のワード文書に視覚的なコンテキストを追加するために使用できます。 文、段落、または単なる平文のテキストを説明するため。 Word文書(.docx)への画像の追加は、IronWord (DOCXファイルを扱うためのC#ライブラリ)で簡単にできます。 このガイドでは、.NET環境で.docxファイルに画像を追加するために必要な手順を説明します。

IronWordを試す

今日あなたのプロジェクトでIronWordを無料トライアルで使用開始。

最初のステップ：
green arrow pointer

DOCXに画像を追加する方法

  1. IronWordの最新安定版をダウンロードしてインストールしてください。
  2. 新しいWord文書を初期化する
  3. 画像オブジェクト（.bmp、.jpg、.png、またはその他のサポートされている形式）を定義します。
  4. ドキュメントに画像を追加
  5. ドキュメントファイルの保存

画像の追加

画像は、ローカルシステムでの定義されたパスを使ってプログラム的に参照されます。 まず、ファイルパスを文字列で提供してImageContentクラスをインスタンス化します。 その後、image 変数は全ファイルを通してさまざまな場所で使用可能であり、プロパティ（例：幅、高さ）を修正するだけでも使用できます。 最後に、AddImage() 関数を使用して.docxファイルに画像を追加します。 追加された後、文書はローカルにエクスポート、保存可能です。 以下の例では、任意の親ノードなしで文書内に画像を追加しています。 サポートされているファイル形式は: .jpg、.png、.bmp、.tiff、.gifです。

BRACKET-t-OPEN--段落内の子要素として画像を挿入し、ドキュメントの階層構造を改善することができます。 段落では、テキストの折り返しやその他のテキストフォーマットプロパティも定義できます。

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

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.jpg");

// modifying image properties
image.Width = 200;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("inserted-image.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
画像を追加

ストリーム経由で画像を追加

ローカルまたは静的URL経由で提供される画像は、前述の手法を使用して.docxファイルに直接追加するのが非常に簡単です。 認証が必要なセキュアAPIの背後にある画像を追加するには、Stream メソッドが適しているでしょう。 以下の例では、HTTPクライアントが認証トークンをサーバーに送信し、認証された画像ストリームを検証後に取得し、最終的な.docxファイルのエクスポート前に直接統合します。

:path=/static-assets/word/content-code-examples/how-to/add-image-insert-image-via-http-stream.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

using (HttpClient client = new HttpClient())
{
    // Add authentication headers
    client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY_HERE");
    client.DefaultRequestHeaders.Add("User-Agent", "MyApp/1.0");

    // Get image from authenticated endpoint
    Stream authenticatedStream = client.GetStreamAsync("https://api.example.com/secure/image.png");
    doc.AddImage(authenticatedStream);
}

// Export docx
doc.SaveAs("added-image-via-http-stream.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

画像プロパティの変更

IronWordは、画像のためのデフォルトのカスタマイズ方法を提供します。

設定 翻訳内容 翻訳例
Width 画像の水平寸法（ピクセル image.Width = 500;
Height 画像の縦寸法（ピクセル image.Height = 300;
WrapText 画像の周りのテキストの折り返し動作 image.WrapText = WrapText.Square;
DistanceFromLeft 左端からのスペーシング（単位：ピクセル image.DistanceFromLeft = 10;
DistanceFromRight 右端からのスペーシング（単位：ピクセル image.DistanceFromRight = 10;
DistanceFromTop 上端からのスペーシング（単位：ピクセル image.DistanceFromTop = 15;
DistanceFromBottom 下端からのスペーシング（単位：ピクセル image.DistanceFromBottom = 15;
Position 空間配置情報（XおよびY座標） image.Position = new ElementPosition(50, 100);
Scale X軸とY軸の比例サイズ係数 image.Scale = new PointF(1.5f, 1.5f);
Translate 再配置のための変位座標 image.Translate = new PointF(20, 30);

幅と高さのカスタマイズ

カスタム幅と高さは、事前定義されたアスペクト比を変更して導入できます。

:path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.tiff");

// modifying the aspect ratio by introducing custom width
image.Width = 800;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("custom-size-image.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
画像のカスタムサイズを追加

よくある質問

C#を使用して画像をDOCXファイルに追加するにはどうすればよいですか？

C#でプログラムでIronWordを利用してDOCXファイルに画像を追加できます。これは画像の挿入を含むWordドキュメントの操作を容易にします。

IronWordを使用してDOCXにどの種類の画像を追加できますか？

IronWordはJPEG、PNG、BMP、GIFなど、さまざまな画像フォーマットをサポートしており、DOCXファイルに追加できます。

IronWordを使用してWordドキュメント内で画像を配置できますか？

はい、IronWordを使用すると、Wordドキュメント内で画像の配置を正確に制御でき、場所と整列を指定できます。

IronWordを使用して1つのWordドキュメントに複数の画像を追加できますか？

もちろんです。IronWordは、1つのWordドキュメントに複数の画像を追加することをサポートしており、複雑なドキュメントレイアウトを可能にします。

IronWordはヘッダーとフッターへの画像の追加をサポートしていますか？

はい、IronWordを使用して、Wordドキュメント内のヘッダーとフッターに画像を追加でき、ドキュメントのデザインを向上させます。

IronWordは画像のスケーリングとリサイズをどのように処理しますか？

IronWordはWordドキュメントに画像が追加される際にスケーリングおよびリサイズする機能を提供しており、レイアウトにシームレスにフィットします。

IronWordを使ってDOCXファイル内の画像にキャプションを追加できますか？

はい、IronWordを使って画像にキャプションを追加することができ、Wordドキュメント内の明確さとコンテキストを向上させます。

IronWordを使用してWordドキュメント内の既存の画像を置き換えることができますか？

IronWordを利用して、Wordドキュメント内の既存の画像を置き換えることができ、ドキュメントの更新と編集に柔軟性を提供します。

DOCXファイルに画像を追加するためにIronWordを使用するためのシステム要件は何ですか？

IronWordは.NETフレームワークのサポートを必要とし、Windows、macOS、およびLinux環境との互換性があり、DOCXファイルに画像を追加できます。

IronWordを使用してDOCXファイルに画像を追加するプロセスを自動化できますか？

はい、IronWordはDOCXファイル内の画像追加プロセスの自動化を容易にし、ドキュメントの作成と編集タスクを効率化します。

Ahmad Sohail
Ahmad Sohail
  今すぐエンジニアリングチームとチャット
フルスタックデベロッパー

Ahmadは、C#、Python、およびウェブ技術に強い基盤を持つフルスタック開発者です。彼はスケーラブルなソフトウェアソリューションの構築に深い関心を持ち、デザインと機能が実際のアプリケーションでどのように融合するかを探求することを楽しんでいます。

Iron Softwareチームに参加する前、Ahmadは自動化プロジェクトやAPI統合に取り組み、パフォーマンスの向上と開発者の体験向上に注力してきました。

彼の自由時間には、UI/UXのアイデアを試したり、オープンソースツールに貢献したり、時折テクニカルライティングやドキュメンテーションに取り組んで、複雑なトピックを理解しやすくすることを目指しています。

準備はできましたか？
Nuget ダウンロード 27,129 | Version: 2025.11 リリース