方法: Web パフォーマンステストプラグインを作成する

[アーティクル]
02/21/2013

Web パフォーマンステストプラグインを使用すると、Web パフォーマンステストの主要な宣言ステートメントとコードを分離し、そのコードを再利用できます。カスタマイズされた Web パフォーマンステストプラグインには、Web パフォーマンステストの実行時に一部のコードを呼び出す方法が用意されています。Web パフォーマンステストプラグインは、テストイテレーションごとに 1 回実行されます。また、テストプラグインで PreRequest メソッドまたは PostRequest メソッドをオーバーライドすると、これらの要求プラグインは各要求のそれぞれ前または後に実行されます。

カスタマイズされた Web パフォーマンステストプラグインは、WebTestPlugin 基本クラスから独自のクラスを派生することによって作成できます。

記録した Web パフォーマンステストではカスタマイズされた Web パフォーマンステストプラグインを使用できるため、最小限のコードを記述するだけで、Web パフォーマンステストをより高度に制御できるようになります。ただし、コード化された Web パフォーマンステストでそれらを使用することもできます。詳細については、「方法: コード化された Web パフォーマンステストを作成する」を参照してください。

[!メモ]

ロードテストプラグインも作成できます。詳細については、「方法 : ロードテストプラグインを作成する」を参照してください。

要件

Visual Studio Ultimate

カスタム Web パフォーマンステストプラグインを作成するには

Web パフォーマンステストが含まれている Web パフォーマンステストおよびロードテストプロジェクトを開きます。

Web パフォーマンステストおよびロードテストを作成する方法の詳細については、方法: 自動テスト用にテストプロジェクトを作成および構成するを使用して、" " を参照してください。
ソリューションエクスプローラーで、ソリューションを [追加] を右クリックし、[新しいプロジェクト] を選択します。

[新しいプロジェクトの追加] ダイアログボックスが表示されます。
[インストールされているテンプレート] の [Visual C#] を選択します。
テンプレートの一覧で、[クラスライブラリ] を選択します。
[名前] ボックスに、クラスの名前を入力します。
[OK] をクリックします。
新しいクラスライブラリプロジェクトがソリューションエクスプローラーに追加され、新しいクラスがコードエディターに表示されます。
ソリューションエクスプローラーで、新しいクラスライブラリの [参照設定] フォルダーを右クリックし、[参照の追加] を選択します。
[参照の追加] ダイアログボックスが表示されます。
[.NET] タブをクリックし、スクロールし、を [Microsoft.VisualStudio.QualityTools.WebTestFramework] を選択します。
[OK] をクリックします。

Microsoft.VisualStudio.QualityTools.WebTestFramework への参照がソリューションエクスプローラーの [参照設定] フォルダーに追加されます。
ソリューションエクスプローラーで、Web パフォーマンステストプラグインを追加し、[参照の追加] を選択するロードテストを含む Web パフォーマンス上のノードを右クリックし、ロードテストプロジェクトが。
[参照の追加] ダイアログボックスが表示されます。
[プロジェクト] タブをクリックし、クラスライブラリプロジェクトを選択します。
[OK] をクリックします。
コードエディターで、プラグインのコードを記述します。まず、WebTestPlugin クラスから派生する新しいパブリッククラスを作成します。
PreWebTest イベントハンドラーと PostWebTest イベントハンドラーのいずれかまたは両方にコードを実装します。実装のサンプルについては、次の例を参照してください。
このコードを記述した後で、新しいプロジェクトをビルドします。
Web パフォーマンステストを開きます。
Web パフォーマンステストプラグインを追加するには、ツールバーの [Web テストプラグインの追加 ] を選択します。

[Web テストプラグインの追加] ダイアログボックスが表示されます。
[プラグインの選択] で、Web パフォーマンステストプラグインクラスを選択します。
[選択したプラグインのプロパティ] ペインで、実行時に使用するプラグインの初期値を設定します。

[!メモ]

プラグインのプロパティをパブリック、設定可能、および基本型 (整数型、ブール型、文字列型など) として設定して、任意の数だけ公開できます。Web パフォーマンステストプラグインのプロパティは、後で [プロパティ] ウィンドウを使用して変更することもできます。

[OK] をクリックします。

[Web テストプラグイン] フォルダーにプラグインが追加されます。

注意
プラグインを使用する Web パフォーマンステストまたはロードテストを実行すると、次のようなエラーメッセージが表示されることがあります。 Request failed: Exception in <plug-in> event: Could not load file or assembly '<"Plug-in name".dll file>, Version=<n.n.n.n>, Culture=neutral, PublicKeyToken=null' or one of its dependencies.The system cannot find the file specified. この問題が発生するのは、いずれかのプラグインのコードを変更して、新しい DLL バージョン (Version=0.0.0.0) を作成したのに、プラグインが元のプラグインバージョンを参照したままになっている場合です。この問題を解決するには、次の手順を実行します。 Web パフォーマンステストおよびロードテストプロジェクトで、参照に関する警告が表示されます。プラグイン DLL への参照を削除し、再度追加します。プラグインをテストまたは該当する場所から削除し、その後、追加し直します。

プラグインを使用する Web パフォーマンステストまたはロードテストを実行すると、次のようなエラーメッセージが表示されることがあります。

Request failed: Exception in <plug-in> event: Could not load file or assembly '<"Plug-in name".dll file>, Version=<n.n.n.n>, Culture=neutral, PublicKeyToken=null' or one of its dependencies.The system cannot find the file specified.

この問題が発生するのは、いずれかのプラグインのコードを変更して、新しい DLL バージョン (Version=0.0.0.0) を作成したのに、プラグインが元のプラグインバージョンを参照したままになっている場合です。この問題を解決するには、次の手順を実行します。

Web パフォーマンステストおよびロードテストプロジェクトで、参照に関する警告が表示されます。プラグイン DLL への参照を削除し、再度追加します。
プラグインをテストまたは該当する場所から削除し、その後、追加し直します。

使用例

次のコードでは、テストイテレーションを表す WebTestContext に項目を追加する、カスタマイズされた Web パフォーマンステストプラグインを作成します。

Web パフォーマンステストの実行後は、このプラグインを使用することにより、TestIteratnionNumer という名前の追加された項目を、Web パフォーマンステスト結果ビューアーの [コンテキスト] タブで確認できます。

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.VisualStudio.TestTools.WebTesting;

namespace SampleRules
{
    public class SampleWebTestPlugin : WebTestPlugin
    {
        // start counting iterations at 1 not 0
        // so that the iteration number we give matches the run number
        static int testIterationNumber = 1;

        public override void PostWebTest(object sender, PostWebTestEventArgs e)
        {
        }

        public override void PreWebTest(object sender, PreWebTestEventArgs e)
        {
            e.WebTest.Context["TestIterationNumber"] = testIterationNumber;
            testIterationNumber++;
        }
    }
}