ILoadTestPlugin インターフェイス
更新 : 2007 年 11 月
ロード テストとロード テストに含まれる各テストの実行時に発生するイベントを、ユーザー記述クラスで処理できるようにするために実装されるインターフェイスを定義します。
名前空間 : Microsoft.VisualStudio.TestTools.LoadTesting
アセンブリ : Microsoft.VisualStudio.QualityTools.LoadTestFramework (Microsoft.VisualStudio.QualityTools.LoadTestFramework.dll 内)
構文
'宣言
Public Interface ILoadTestPlugin
'使用
Dim instance As ILoadTestPlugin
public interface ILoadTestPlugin
public interface class ILoadTestPlugin
public interface ILoadTestPlugin
解説
これをユーザー記述クラスによって実装すると、エージェントのロード テスト ランタイム エンジンにユーザー記述コードを接続できます。このプラグインは、ロード テスト エディタで指定します。
ロード テスト プラグインを作成すると、たとえば、しきい値に違反した後、ロード テストの開始前や終了後、テストの反復の開始前や終了後、ロード テストの中断時、テストでのロードの変更時など、ロード テストの実行時のさまざまな時点でコードを実行できます。ILoadTestPlugin の実装が処理できるイベントは、LoadTestStarting、LoadTestFinished、LoadTestWarmupComplete、TestStarting、TestFinished、TestSelected、ThresholdExceeded、HeartBeat()、および LoadTestAborted です。
ロード テスト プラグインの実装を使用すると、ロード テストの実行時にテストの動作を拡張したり、変更したりできます。ロード テスト プラグインの用途のいくつかを次の一覧に示します。
監視ツールなどの外部プロセスを、ロード テストの開始直前に起動し、テストの完了時に停止する。
ロード テストの実行時に使用されるユーザー ロードをプログラムで制御できるようにし、ロード テスト エディタで指定されたユーザー ロードをオーバーライドする。
ロード テスト内で実行する個々のテストの選択をプログラムで制御できるようにし、既定のテスト選択アルゴリズムをオーバーライドする。
パフォーマンス カウンタの値によって、ロード テストで定義されたしきい値規則のエラーが発生した場合にロード テストを中断する。
ロード テスト内のテストのすべての反復で共有される変数を保持する。このために、ロード テスト プラグインは、ロードの下でテストによってアクセスされる静的プロパティとして変数を実装します。この変数は、ロード テスト プラグインの Initialize メソッドで初期化されます。報告の目的で最終値へのアクセスに使用できる LoadTestFinished イベントのイベント ハンドラが追加されます。
実装元へのメモ :
ロード テストを複数のエージェントで実行するときは、ロード テスト プラグイン クラスをすべてのエージェントでインスタンス化します。ロード テスト プラグインの操作を 1 つのエージェントでのみ実行する場合は、LoadTestContext オブジェクトの AgentId プロパティをチェックし、AgentId の値が 1 の場合にのみ操作を実行する必要があります。
例
例については、方法 : ロード テスト プラグインを作成する を参照してください。