方法 : 要求レベルのプラグインを作成する

[アーティクル]
07/21/2016

発行: 2016年7月

要求は、Web パフォーマンステストを構成する宣言ステートメントです。 Web パフォーマンステストプラグインを使用すると、Web パフォーマンステストの主要な宣言ステートメントとコードを分離し、そのコードを再利用できます。プラグインを作成し、要求を含む Web パフォーマンステストに追加するのと同じように、個々の要求にも追加できます。カスタマイズされた要求プラグインを使用すると、Web パフォーマンステスト中の特定の要求の実行時にコードを呼び出すことができます。

すべての Web パフォーマンステスト要求プラグインには、PreRequest メソッドと PostRequest メソッドがあります。要求プラグインを特定の HTTP 要求にアタッチすると、その要求の発行前に PreRequest イベントが発生し、応答の受信後に PostRequest が起動します。

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

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

必要条件

Visual Studio Enterprise

要求レベルのプラグインを作成するには

ソリューションエクスプローラーでソリューションを右クリックします。 [追加] を選択して、[新しいプロジェクト] を選択します。

[新しいプロジェクトの追加] ダイアログボックスが表示されます。
[インストールされているテンプレート] の [Visual C#] を選択します。
テンプレートの一覧で、[クラスライブラリ] を選択します。
[名前] ボックスにクラスの名前を入力し、[OK] をクリックします。

新しいクラスライブラリプロジェクトがソリューションエクスプローラーに追加され、新しいクラスがコードエディターに表示されます。
ソリューションエクスプローラーで、新しいクラスライブラリの [参照設定] フォルダーを右クリックし、[参照の追加] を選択します。

[参照の追加] ダイアログボックスが表示されます。
[.NET] タブをクリックします。スクロールダウンし、[Microsoft.VisualStudio.QualityTools.WebTestFramework] を選択して、[OK] をクリックします。

Microsoft.VisualStudio.QualityTools.WebTestFramework への参照がソリューションエクスプローラーの [参照設定] フォルダーに追加されます。
ソリューションエクスプローラーで、Web パフォーマンステスト要求のテストプラグインの追加先であるロードテストを含んでいる Web パフォーマンスとロードテストプロジェクトの最上位ノードを右クリックします。 [参照の追加] をクリックします。

[参照の追加] ダイアログボックスが表示されます。
[プロジェクト] タブをクリックします。次に、[クラスライブラリプロジェクト] をクリックし、[OK] をクリックします。
コードエディターで、プラグインのコードを記述します。まず、WebTestRequestPlugin クラスから派生する新しいパブリッククラスを作成します。
PreRequest イベントハンドラーと PostRequest イベントハンドラーのいずれかまたは両方にコードを実装します。実装のサンプルについては、次の例を参照してください。
このコードを記述した後で、新しいプロジェクトをビルドします。
要求プラグインを追加する Web パフォーマンステストを開きます。
要求プラグインを追加する要求を右クリックし、[要求プラグインの追加] をクリックします。

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

注意

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

プラグインは、HTTP 要求の子フォルダーである [要求プラグイン] フォルダーに追加されます。
警告

プラグインを使用する 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) を作成したのに、プラグインが元のプラグインバージョンを参照したままになっている場合です。この問題を解決するには、次の手順を実行します。
1. Web パフォーマンスとロードテストのプロジェクトで、参照に関する警告が表示されます。プラグイン DLL への参照を削除し、再度追加します。
2. プラグインをテストまたは該当する場所から削除し、その後、追加し直します。

使用例

次のコードを使用して、2 つのダイアログボックスを表示するカスタマイズされた Web パフォーマンステストプラグインを作成できます。 1 つのダイアログボックスには、要求アドインにアタッチする要求に関連付けられている URL が表示されます。もう 1 つのダイアログボックスには、エージェントのコンピューター名が表示されます。

注意

次のコードでは、System.Windows.Forms への参照を追加する必要があります。

using System;
using System.Collections.Generic;
using System.Windows.Forms;
using Microsoft.VisualStudio.TestTools.WebTesting;

namespace RequestPluginNamespace
{
    public class MyWebRequestPlugin : WebTestRequestPlugin
    {
        public override void PostRequest(object sender, PostRequestEventArgs e)
        {
            MessageBox.Show(e.WebTest.Context.AgentName);
        }
        public override void PreRequest(object sender, PreRequestEventArgs e)
        {
            MessageBox.Show(e.Request.Url);
        }
    }
}

参照

WebTestRequestPlugin
ロードテスト用のカスタムコードおよびカスタムプラグインの作成
 Web パフォーマンステストのカスタム抽出規則のコーディング
 Web パフォーマンステストのカスタム検証規則のコーディング
 方法 : ロードテストプラグインを作成する
 [廃版] 方法: コード化された Web パフォーマンステストを作成する
 方法: 既存の Web パフォーマンステストを編集する

次の方法で共有

方法 : 要求レベルのプラグインを作成する

要求レベルのプラグインを作成するには

使用例

参照

その他のリソース