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

How to Add Image to DOCX

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

画像は、既存のワード文書に視覚的なコンテキストを追加するために使用できます。 文、段落、または単なるテキストブロックを説明するために。 IronWord（DOCXファイルを操作するためのC#ライブラリ）を使用すると、Word文書（.docx）への画像の追加は簡単かつ直感的です。 このチュートリアルでは、.NET環境内で.docxファイルに画像を追加するための基本をカバーします。

IronWordを試す

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

最初のステップ：
green arrow pointer

class="hsg-featured-snippet">

DOCXに画像を追加する方法

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

画像の追加

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

ヒント画像は文書階層を改善するために、段落内の子要素として挿入できます。 段落はまた、テキストラッピングやその他のテキストフォーマットプロパティを定義できます。

: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
class="content-img-align-center">
class="center-image-wrapper"> 画像を追加

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

ローカルまたは静的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は、画像のためのデフォルトのカスタマイズ方法を提供します。

設定 説明 例
幅 画像の水平寸法（ピクセル） image.Width = 500;
高さ 画像の垂直寸法（ピクセル） image.Height = 300;
WrapText 画像周りのテキストラッピング動作 image.WrapText = WrapText.Square;
左からの距離 ピクセル単位での左端からのスペーシング測定 image.DistanceFromLeft = 10;
右からの距離 ピクセル単位での右端からのスペーシング測定 image.DistanceFromRight = 10;
上からの距離 ピクセル単位での上端からのスペーシング測定 image.DistanceFromTop = 15;
下からの距離 ピクセル単位での下端からのスペーシング測定 image.DistanceFromBottom = 15;
位置 空間的な配置情報（XおよびY座標） image.Position = new ElementPosition(50, 100);
スケール X軸およびY軸の比率的なサイズ変化要因 image.Scale = new PointF(1.5f, 1.5f);
平面移動 再配置のための座標変位 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
class="content-img-align-center">
class="center-image-wrapper"> 画像のカスタムサイズを追加

よくある質問

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 ダウンロード 25,807 | バージョン: 2025.11 ただ今リリースされました