GroupDocs.Conversion .NET を使用して VSTM ファイルを JPG に変換する

導入

Visual Studio Test Manager (VSTM) ファイルを高品質の JPG 画像に変換することは、Microsoft のテストツールを使用しないチームメンバーとテスト結果を共有する上で不可欠です。この包括的なガイドでは、様々な形式のファイル変換を簡素化するために設計された堅牢なライブラリ、GroupDocs.Conversion .NET の使い方を説明します。

このチュートリアルでは、次の内容を取り上げます。

アプリケーションにVSTMファイルを読み込む
JPG出力の変換オプションの設定
変換プロセスの実装以下の手順に従うことで、GroupDocs.Conversion .NET を使って VSTM ファイルを JPG に効率的に変換する方法を習得できます。早速始めましょう！

前提条件

始める前に、次のものを用意してください。

必要なライブラリと依存関係:

GroupDocs.Conversion for .NET バージョン 25.3.0 以上。
Visual Studio のような互換性のある開発環境。

環境設定要件:

お使いのマシンに .NET Framework (4.6.1 以降) または .NET Core/5+ がインストールされている必要があります。

知識の前提条件:

C# プログラミングと .NET プロジェクト構造に関する基本的な理解。

GroupDocs.Conversion for .NET のセットアップ

インストール

GroupDocs.Conversion を使用するには、.NET プロジェクトにインストールしてください。手順は以下のとおりです。

NuGet パッケージマネージャーコンソール

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

ライセンス取得

無料トライアル試用版をダウンロードするには、 GroupDocsウェブサイト.
一時ライセンスフル機能アクセスのための一時ライセンスをリクエストするには、このリンク.
購入長期間にわたって中断なく使用する必要がある場合は、ライセンスの購入を検討してください。

基本的な初期化

C# アプリケーションで GroupDocs.Conversion を初期化する方法は次のとおりです。

using System;
using GroupDocs.Conversion;

class Program
{
    static void Main()
    {
        // 変換設定を設定する
        string documentPath = "YOUR_DOCUMENT_DIRECTORY/sample.vstm";
        
        using (Converter converter = new Converter(documentPath))
        {
            Console.WriteLine("Conversion setup completed.");
        }
    }
}

実装ガイド

VSTMファイルを読み込む

概要このセクションでは、VSTM ファイルをロードして変換の準備をすることに焦点を当てます。

ドキュメントパスを定義する

string documentPath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.vstm");

説明：使用 Path.Combine VSTM ファイルへの完全なパスを作成し、さまざまなオペレーティングシステム間での互換性を確保します。

コンバーターオブジェクトを初期化する

using (Converter converter = new Converter(documentPath))
{
    // コンバーター オブジェクトは、変換操作の準備が整いました。
}

説明これはインスタンスを作成します Converter 後続のすべての変換タスクを処理します。

JPG変換オプションを設定する

概要ドキュメントを JPG 画像形式に変換するために必要なオプションを設定します。

画像変換オプションの作成

using GroupDocs.Conversion.Options.Convert;

ImageConvertOptions jpgOptions = new ImageConvertOptions {
    Format = GroupDocs.Conversion.FileTypes.ImageFileType.Jpg // ターゲット形式をJPGとして指定する
};

説明：その ImageConvertOptions クラスを使用すると、必要な出力形式やその他の設定を指定できます。

VSTMをJPGに変換する

概要このセクションでは、読み込まれた VSTM ファイルをページまたはドキュメントセグメントごとに 1 つずつ複数の JPG ファイルに変換する方法について詳しく説明します。

出力パスとファイルテンプレートを定義する

string outputFolder = "YOUR_OUTPUT_DIRECTORY";
string outputFileTemplate = Path.Combine(outputFolder, "converted-page-{0}.jpg");

ページストリームを処理する関数を作成する

Func<SavePageContext, Stream> getPageStream = savePageContext => new FileStream(
    string.Format(outputFileTemplate, savePageContext.Page), FileMode.Create);

説明この機能は、変換された JPG ファイルの各ページのファイルストリームを生成します。

変換を実行する

using (Converter converter = new Converter(Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.vstm")))
{
    ImageConvertOptions options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Jpg };
    converter.Convert(getPageStream, options);
}

説明以前に定義されたオプションとストリームを使用して変換を開始します。

実用的なアプリケーション

自動レポートCI/CD パイプラインと統合して、テスト結果をレポート用の画像に自動的に変換します。
ドキュメントの共有Microsoft ソフトウェアを必要とせずに、VSTM ファイルを視覚的な形式で関係者と簡単に共有できます。
Webアプリとの統合Web アプリケーション内に変換機能を埋め込み、ユーザーが結果を画像としてダウンロードできるようにします。

パフォーマンスに関する考慮事項

メモリ使用量の最適化メモリリークを防ぐために、ストリームとオブジェクトをすぐに破棄します。
バッチ処理特に大きなファイルの場合、リソースの使用を最適化するためにドキュメントをバッチで変換します。
非同期メソッドを使用する可能な場合は、非同期メソッドを活用してアプリケーションの応答性を向上させます。

結論

GroupDocs.Conversion .NETを使ってVSTMファイルをJPG画像に変換する方法をマスターしました。この強力なライブラリはドキュメント変換作業を簡素化し、他のシステムとシームレスに統合できます。さらに詳しく知りたい場合は、GroupDocs.Conversionでサポートされている他の形式を調べたり、より高度な設定を試したりすることを検討してください。

FAQセクション

VSTM ファイルとは何ですか?
- VSTM ファイルは、Visual Studio Test Manager によってテスト結果を保存するために使用されます。
GroupDocs.Conversion .NET を使用して VSTM 以外のファイルを変換できますか?
- はい、幅広いドキュメント形式をサポートしています。
変換できるページ数に制限はありますか?
- 固有のページ制限はありませんが、大きなドキュメントの場合はパフォーマンスとメモリ使用量を考慮してください。
変換エラーをどのように処理すればよいですか?
- 例外を適切に管理するために、変換コードの周囲にエラー処理を実装します。
GroupDocs.Conversion .NET はクラウド環境で使用できますか?
- はい、Azure や AWS を含むさまざまなプラットフォームにデプロイできます。

リソース

これで知識が身についたので、GroupDocs.Conversion .NET を使用して独自のドキュメント変換ソリューションを実装してみましょう。