C#/IronWordでDOCXから画像を抽出する

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWordのExtractImages()メソッドは、プログラムによってWord文書からすべての埋め込み画像を抽出することを可能にし、保存や処理のために寸法やフォーマットのような画像データやメタデータへのアクセスを提供します。

クイックスタート: C#でDOCXから画像を抽出する

```csharp {title="クイック画像抽出の例"}。 // IronWordをインストールします:IronWordをインストールします。 IronWordを使用しています;

// ワード文書を読み込む WordDocument doc = new WordDocument("document.docx");

// すべての画像を抽出 var images = doc.ExtractImages();

// 各画像をカスタムネーミングで保存 int imageIndex = 0; foreach (var image in images) { // 指定フォーマットへの保存 image.SaveAs($"output-{imageIndex}.png");

// 画像プロパティへのアクセス
Console.WriteLine($"Image {imageIndex}: {image.Width}x{image.Height}");
imageIndex++;

}


Word 文書から画像を抽出することは、コンテンツの移行、メディア管理、プログラムによる文書処理の一般的な要件です。 コンテンツ管理システムの構築、文書ワークフローの自動化、デジタルアーカイブの作成など、IronWordは埋め込み画像へのアクセスを簡素化し、寸法やフォーマットなどのプロパティを通して保存、再利用、分析を可能にします。

`ExtractImages()`関数は、ドキュメントからすべての画像を取得し、そのメタデータにアクセスしてさらに処理するためのシンプルで効率的な方法を提供します。 このメソッドは、生の画像データと有用なメタデータ・プロパティの両方を含む画像オブジェクトのコレクションを返します。 [PowerPointプレゼンテーション](https://ironsoftware.com/csharp/ppt/examples/create-empty-presentation/)を使用している開発者のために、同様の機能は他のIronライブラリにも存在し、製品スイート全体で一貫したAPI設計を実証しています。

### IronWordを使い始めるには?

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

最初のステップ:
green arrow pointer
--- <div class="hsg-featured-snippet"> <h2>DOCXから画像を抽出する方法</h2> <ol> <li>DOCXから画像を抽出するC#ライブラリのダウンロード</li> <li>既存のWord文書を読み込む</li> <li><code>ExtractImages</code>を使用して画像コンテンツにアクセスして抽出する</li> <li>抽出した画像をディスクに保存</li> <li>画像ファイルの処理またはエクスポート</li> </ol> </div> ## Word文書から画像を抽出するにはどうすればよいですか? <!-- TODO: ここに画像を追加 -->. <!-- !![抽出画像の実装例を示す図](/static-assets/images/TODO/extract-images-example-code_illustration.webp) -->。 <!コードの概念を示す図またはスクリーンショット -->。 IronWord を使用すると、Word 文書から画像を抽出するのは簡単です。 `embedded_images.docx`は、3つの異なるページに5つの画像を含むサンプルファイルとして使用されます。 以下のコード スニペットは、`ExtractImages()` メソッドを使用した画像抽出プロセスのコア ワークフローを定義しています。 文書処理ライブラリを使用する場合、[ライセンス要件](https://ironsoftware.com/csharp/ppt/licensing/)を理解し、アプリケーションが使用条件に準拠していることを確認することが不可欠です。 IronWordは他のIron製品と同様のライセンスパターンで、包括的なサポートオプション付きの永久ライセンスを提供しています。 実運用には、[ライセンスキー](https://ironsoftware.com/csharp/ppt/get-started/license-keys/)を適用して、透かしや制限を取り除く必要があります。 ```csharp :path=/static-assets/word/content-code-examples/how-to/extract-images-properties.cs

ExtractImages()メソッドは、画像オブジェクトの列挙可能なコレクションを返します。 このアプローチにより、柔軟な処理ワークフローが可能になります。上記のように画像をディスクに保存したり、異なるフォーマットに変換したり、クラウドストレージサービスに直接ストリーミングしたりすることができます。 この方法では、JPEG、PNG、BMP、GIFなど、Word文書によく埋め込まれるさまざまな画像形式を扱います。

サンプル文書はどのようなものですか?

画像を埋め込んだWord文書:Googleのロゴ、頭のシルエット、銀河のシーン、ライオン、禅の石

どのようなアウトプットを期待すればよいですか?

抽出された 5 つの画像を寸法とファイル名で表示するデバッグ コンソール extracted-image-0.png ~ extracted-image-4.png.

抽出された画像は、元の形式(.jpg.png、またはその他の形式)を保持し、適切なファイル拡張子で保存することができます。 ドキュメント内のすべての画像を反復処理したり、要件に基づいて特定のセクションをターゲットにしたりすることができます。

高度な画像抽出シナリオ

IronWordの画像処理機能は、基本的な抽出だけでなく、開発者がプロダクション・アプリケーションで頻繁に遭遇するいくつかの高度なシナリオをサポートしています:

複数ドキュメントのバッチ処理:大規模な文書コレクションを処理する場合、複数のWordファイルから同時に画像を抽出する並列処理を実装できます。 このアプローチは、ドキュメントアーカイブやコンテンツ移行プロジェクトの処理時間を大幅に短縮します。

画像フォーマットの変換: 抽出された画像オブジェクトは、フォーマット間の変換をサポートします。 Word文書からJPEGを抽出し、Web最適化のためにPNGとして保存したり、モダンブラウザとの互換性のためにWebPに変換したりすることもあります。

メタデータの保持:抽出された各画像は、寸法、解像度、色深度などの重要なメタデータを保持します。 この情報は、画像の最適化パイプラインを実装したり、アプリケーション全体の品質基準を維持したりする際に役立ちます。

継続的なサポートと定期的なアップデートが必要なエンタープライズ アプリケーションについては、新機能への継続的なアクセスと優先的なサポートを提供する license extensions を検討してください。 プロジェクトのスコープが拡大した場合、アップグレードオプションは、追加の開発者や配置場所をカバーするためにシームレスなスケーリングを可能にします。

ドキュメントワークフローとの統合

画像抽出は、大規模な文書処理ワークフローの一部を構成することがよくあります。 一般的な統合パターンを考えてみましょう:

コンテンツ管理システム:ドキュメントのアップロード中に画像を抽出して、サムネイルプレビューを作成したり、画像ギャラリーを構築したり、メディアライブラリに入力したりします。 抽出された画像は、検索機能のためにインデックス化したり、ドキュメントのメタデータにタグ付けしたりすることができます。

ドキュメント変換パイプライン:Word文書を他の形式に変換する際、抽出した画像を個別に処理して最適な品質にすることができます。 たとえば、ウェブ出力と印刷出力で異なる圧縮設定を適用するなどです。

品質保証ワークフロー:自動抽出により、ブランドガイドライン、解像度要件、ファイルサイズの制約に準拠しているかどうか、埋め込み画像の体系的なレビューが可能になります。 低解像度の画像や不正確なフォーマットを含む文書は、公開前にフラグを立てることができます。

ドキュメント処理機能の最新機能や改善点の最新情報を入手するには、製品の変更履歴を定期的にチェックしてください。 新しいリリースには、画像抽出ワークフローに役立つパフォーマンスの強化やフォーマットサポートの拡張が含まれていることがよくあります。

パフォーマンスの考慮事項

多数の画像や高解像度の画像を含む文書を扱う場合は、以下のパフォーマンス最適化戦略を考慮してください:

メモリ管理:すべての画像を同時にメモリにロードするのではなく、バッチで画像を処理します。 このアプローチにより、大きな文書や高解像度の画像を扱う際のメモリの消耗を防ぐことができます。

非同期処理: I/O操作、特に抽出した画像をディスクやネットワークストレージに保存するときに、非同期/待機パターンを実装します。 これにより、長時間の抽出作業中も、アプリケーションの応答性が保たれます。

選択的抽出:特定の画像だけが必要な場合は、不要なコンテンツの処理を避けるために、画像プロパティや文書構造に基づいたフィルタの実装を検討してください。

堅牢なAPI設計により、さまざまな文書タイプや画像フォーマットで一貫した動作が保証されるため、信頼性の高い画像抽出機能を.NETアプリケーションに簡単に組み込むことができます。

よくある質問

C#でDOCXファイルから画像を抽出する方法を教えてください。

IronWordのExtractImages()メソッドを使えば、DOCXファイルから画像を抽出することができます。WordDocument doc = new WordDocument("document.docx")でWord文書を読み込み、doc.ExtractImages()を呼び出して埋め込まれた画像をすべて取得します。各画像は、SaveAs() メソッドを使用して、お好みのフォーマットとファイル名で保存できます。

Word文書から画像を抽出する際、どのような画像プロパティにアクセスできますか?

IronWordはWidthとHeightの寸法を含む重要な画像メタデータへのアクセスを提供します。ExtractImages()メソッドは、生の画像データとこれらのメタデータ・プロパティの両方を含む画像オブジェクトのコレクションを返すので、その特徴に基づいてプログラムで画像を分析したり処理したりすることができます。

抽出した画像をさまざまな形式で保存できますか?

はい、IronWordでは抽出した画像をさまざまな形式で保存することができます。各画像オブジェクトのSaveAs()メソッドを使用し、適切な拡張子(例:.png、.jpg)で希望のファイル名を指定してください。ライブラリは、指定された拡張子に基づいて自動的にフォーマット変換を行います。

Word文書から画像を抽出するライブラリのインストール方法を教えてください。

コマンドを使ってNuGet Package Manager経由でIronWordをインストールします:IronWordをインストールします。インストールが完了したら、C#ファイルに'using IronWord;'を追加し、画像抽出機能やその他の文書処理機能にアクセスする。

複数ページのWord文書から画像を抽出することは可能ですか?

はい、IronWordのExtractImages()メソッドは、Word文書全体からページ数に関係なくすべての画像を抽出します。このメソッドは、文書全体に埋め込まれたすべての画像の完全なコレクションを、それが1ページにあるか複数ページにまたがっているかにかかわらず返します。

Ahmad Sohail
フルスタックデベロッパー

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

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

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

準備はできましたか?
Nuget ダウンロード 28,054 | バージョン: 2025.12 リリース