Word ドキュメントを高品質な画像に変換することは、プレビュー生成、サムネイル作成、レポート ダッシュボードなどで頻繁に求められます。 Aspose.OMR Cloud SDK for .NET は、C# コードから DOCX ファイルを PNG 画像に簡単に変換できる強力なクラウドベースのライブラリを提供します。このチュートリアルでは、SDK のセットアップ、完全な非同期サンプルの作成、REST 統合のための同等の cURL 呼び出しの使用方法を学びます。最後には、数行のコードだけで任意の DOCX から透過 PNG を生成できるようになります。
DOCX から PNG ワークフロー - 前提条件とセットアップ
開始する前に、以下のものが必要です:
- .NET 6.0 以降がインストールされていること。
- Aspose Cloud アカウントと API 資格情報（Client ID と Client Secret）。
- Aspose OMR Cloud サービスを呼び出すためのインターネット接続。
NuGet 経由で SDK をインストールする:
dotnet add package Aspose.OMR-Cloud
最新パッケージをダウンロードし、リリースノートをご覧になるには、こちらをご利用ください: Aspose.OMR Cloud SDK for .NET Download。 詳細な API 使用方法については、公式ドキュメント を参照してください。
SDK をクレデンシャルで構成する必要があります:
var config = new Configuration
{
BasePath = "https://api.aspose.cloud",
ApiKey = Environment.GetEnvironmentVariable("ASPOSE_OMR_API_KEY")
};
設定が完了したので、変換ワークフローを開始する準備ができました。
C# で DOCX を PNG に変換するステップバイステップ ガイド
ステップ 1: ソース ドキュメントの読み込み
DOCX ファイルをストリームとして開き、ファイル全体をメモリに読み込むのを回避します。
using var inputStream = new FileStream(inputDocxPath, FileMode.Open, FileAccess.Read, FileShare.Read, bufferSize: 81920, useAsync: true);
ステップ 2: 変換リクエストの作成
ConvertDocumentRequest を作成し、出力形式として PNG を指定します。ConvertOptions を使用すると、透明な背景と DPI を設定できます。
var conversionRequest = new ConvertDocumentRequest
{
InputFile = await ReadStreamFullyAsync(inputStream),
OutputFormat = "png",
Options = new ConvertOptions
{
TransparentBackground = true,
Dpi = 150
}
};
ステップ 3: 変換 API を呼び出す
非同期メソッドを呼び出して変換を実行します。
byte[] pngResult = await omrApi.ConvertDocumentAsync(conversionRequest);
ステップ 4: PNG 結果を保存する
返されたバイト配列をディスク上のファイルに書き込みます。
await File.WriteAllBytesAsync(outputPngPath, pngResult);
Console.WriteLine($"DOCX successfully converted to PNG: {outputPngPath}");
ステップ 5: 例外の処理
API と I/O エラーをキャッチして、プロセスを堅牢にします。
catch (ApiException apiEx)
{
Console.Error.WriteLine($"Aspose OMR API error (Code {apiEx.ErrorCode}): {apiEx.Message}");
}
catch (IOException ioEx)
{
Console.Error.WriteLine($"File I/O error: {ioEx.Message}");
}
catch (Exception ex)
{
Console.Error.WriteLine($"Unexpected error: {ex.Message}");
}
C# で DOCX ファイルを PNG に変換する - 完全なコード例
以下の例は、エンドツーエンドの完全な変換プロセスを示しています。
using System;
using System.IO;
using System.Threading.Tasks;
using Aspose.OMR.Cloud.Sdk.Api;
using Aspose.OMR.Cloud.Sdk.Client;
using Aspose.OMR.Cloud.Sdk.Model;
class Program
{
static async Task Main(string[] args)
{
// -----------------------------------------------------------------
// Configuration – replace with your actual credentials/environment
// -----------------------------------------------------------------
var config = new Configuration
{
// Base URL for Aspose OMR Cloud API
BasePath = "https://api.aspose.cloud",
// API key (or JWT) – read from environment for security
ApiKey = Environment.GetEnvironmentVariable("ASPOSE_OMR_API_KEY")
};
// Initialize the OMR API client
var omrApi = new OMRApi(config);
// Input DOCX and output PNG paths (generic placeholders)
const string inputDocxPath = "input.docx";
const string outputPngPath = "output.png";
try
{
// -------------------------------------------------------------
// Stream the DOCX file – avoids loading the whole file into RAM
// -------------------------------------------------------------
using var inputStream = new FileStream(inputDocxPath, FileMode.Open, FileAccess.Read, FileShare.Read, bufferSize: 81920, useAsync: true);
// -------------------------------------------------------------
// Build conversion request with transparent PNG option
// -------------------------------------------------------------
var conversionRequest = new ConvertDocumentRequest
{
// The SDK expects the document as a byte array; copy via stream efficiently
InputFile = await ReadStreamFullyAsync(inputStream),
OutputFormat = "png",
// Optional conversion settings
Options = new ConvertOptions
{
// Ensure PNG background is transparent
TransparentBackground = true,
// For large documents, limit DPI to balance quality/performance
Dpi = 150
}
};
// -------------------------------------------------------------
// Perform the conversion (async)
// -------------------------------------------------------------
byte[] pngResult = await omrApi.ConvertDocumentAsync(conversionRequest);
// -------------------------------------------------------------
// Write the resulting PNG to disk
// -------------------------------------------------------------
await File.WriteAllBytesAsync(outputPngPath, pngResult);
Console.WriteLine($"DOCX successfully converted to PNG: {outputPngPath}");
}
catch (ApiException apiEx)
{
// Handles errors returned by the Aspose OMR service
Console.Error.WriteLine($"Aspose OMR API error (Code {apiEx.ErrorCode}): {apiEx.Message}");
}
catch (IOException ioEx)
{
// Handles file‑system related errors
Console.Error.WriteLine($"File I/O error: {ioEx.Message}");
}
catch (Exception ex)
{
// Catch‑all for any other unexpected issues
Console.Error.WriteLine($"Unexpected error: {ex.Message}");
}
}
// -----------------------------------------------------------------
// Helper: reads a stream fully into a byte array without blocking UI
// -----------------------------------------------------------------
private static async Task<byte[]> ReadStreamFullyAsync(Stream stream)
{
if (stream is MemoryStream ms && ms.TryGetBuffer(out var buffer))
return buffer.Array;
using var memory = new MemoryStream();
await stream.CopyToAsync(memory);
return memory.ToArray();
}
}
注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや構成値を実際の環境に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。
cURL を使用した REST API で Word ドキュメントを PNG に変換
直接の REST 呼び出しで同じ結果を得ることができます。以下は典型的な cURL ワークフローです。
- アクセストークンを取得する (プレースホルダーを自分の資格情報に置き換えてください)。
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- DOCX ファイルをアップロード ストレージ エンドポイントへ。
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/input.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "input.docx"
- PNG への変換をリクエスト (透過背景が有効)。
curl -X POST "https://api.aspose.cloud/v4.0/omr/convert?outputFormat=png&transparentBackground=true&dpi=150" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@input.docx" \
-o output.png
- 結果の PNG をダウンロード (別のジョブエンドポイントを使用した場合)。
curl -X GET "https://api.aspose.cloud/v4.0/omr/result/output.png" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.png
リクエスト パラメータの詳細については、API リファレンスをご覧ください。
PNG 出力設定: オプションと設定
ConvertOptions オブジェクトを使用すると、PNG 出力を細かく調整できます。コードでは、2 つの重要な設定が示されています。
- TransparentBackground -
trueに設定すると、生成された PNG に背景色がなくなり、オーバーレイシナリオで便利です。 - Dpi - 解像度を制御します。DPI が高いほど画像は鮮明になりますが、メモリ使用量が増加します。ほとんどのウェブユースケースでは、150 DPI が品質とパフォーマンスのバランスを取ります。
圧縮レベルやカラーモードの設定など、追加の制御が必要な場合は、API リファレンス のオプション一覧をご参照ください。
大規模DOCX変換パフォーマンスの最適化
大きな DOCX ファイルを変換する際は、次のヒントをご検討ください:
- 入力をストリーム -
FileStreamを非同期読み取りで使用すると、メモリ使用量が低く抑えられます。 - DPI を調整 - DPI を下げる（例: 100 に）ことで、処理時間と出力サイズが削減されます。
OMRApiクライアントを再利用 - 単一のインスタンスを作成し、複数の変換で再利用して、ハンドシェイクの繰り返しを防ぎます。- 変換を非同期で実行 -
awaitを活用してスレッドを応答可能に保ち、特に Web や UI アプリケーションで有効です。
これらの実践を適用することで、たとえページ数が多いドキュメントや高解像度画像であっても、C# で DOCX を PNG に効率的に変換できます。
結論
C# で DOCX を PNG に変換するのは、Aspose.OMR Cloud SDK for .NET を使用すれば簡単です。上記の手順に従うことで、透過 PNG を生成し、サーバー側のワークフローにプロセスを統合し、大きなファイルのパフォーマンスを微調整できます。この SDK は商用ライセンスで提供されており、製品ページで価格を確認でき、一時ライセンスページ で評価用の一時ライセンスを取得できます。今すぐ DOCX から PNG への変換を統合し、アプリケーションのドキュメント処理機能を強化しましょう。
よくある質問
-
C#でAspose.OMRを使用してDOCXをPNGに変換するにはどうすればよいですか？
サンプルコードに示されている非同期ConvertDocumentAsyncメソッドを使用します。SDK は透明背景のサポートを含む、DOCX から PNG への全体的なワークフローを処理します。 -
.NET で一時ファイルを書き込まずに DOCX を PNG に変換することは可能ですか？
はい。ReadStreamFullyAsyncを使用して DOCX をバイト配列にストリーミングすれば、変換はメモリ内で完結し、クラウドや API シナリオに最適です。 -
PNG出力をカスタマイズできますか？たとえば背景を透明にすることは可能ですか？
もちろんです。ConvertOptionsのTransparentBackground = trueを設定してください。これにより、.NET で DOCX を PNG に変換する際に背景が透明になり、オーバーレイの使用例に最適です。 -
Aspose.OMR Cloud SDK for .NET のライセンスオプションにはどのようなものがありますか？
この SDK は商用ライセンスで提供されています。詳細な価格情報は製品ページに掲載されており、一時ライセンスページ から一時評価ライセンスをリクエストできます。