方法: Web パフォーマンステスト結果ビューアー用に Visual Studio アドインを作成する

[アーティクル]
03/12/2013

次の名前空間を使用して、Web パフォーマンステスト結果ビューアーの UI を拡張できます。

また、%ProgramFiles%\Microsoft の Visual Studio 11.0\Common7\IDE\PrivateAssemblies フォルダーにある LoadTestPackage の DLL への参照を追加する必要があります。

Web パフォーマンステスト結果ビューアーの UI を拡張するには、Visual Studio アドインおよびユーザーコントロールを作成する必要があります。次の手順では、アドインとユーザーコントロールの作成方法、および Web パフォーマンステスト結果ビューアーの UI を拡張するのに必要なクラスを実装する方法について説明します。

要件

Visual Studio Ultimate

ASP.NET Web アプリケーションおよび Web パフォーマンステストおよびロードテストプロジェクトを含むソリューションを作成または開きます。

Web パフォーマンステスト結果ビューアーの拡張の準備をするには

実験 ASP.NET Web アプリケーションの一つ以上の Web パフォーマンステストで ASP.NET Web アプリケーションと Web パフォーマンステストおよびロードテストプロジェクトが対象で使用できる非稼動ソリューションを作成するか開きます。

[!メモ]

チュートリアル: 簡単な Web アプリの作成とチュートリアル: Web パフォーマンステストの記録と実行の手順に従って、Web パフォーマンステストを含む ASP.NET Web アプリケーションおよび Web パフォーマンステストおよびロードテストプロジェクトを作成できます。

Visual Studio アドインの作成

アドインは、Visual Studio 統合開発環境 (IDE: Integrated Development Environment) 内部で実行されるコンパイル済み DLL です。DLL がコンパイルされていることにより、知的財産権が保護され、パフォーマンスが向上します。アドインは手動でも作成できますが、アドインウィザードを使用した方が簡単に作成できます。このウィザードでは、作成後すぐに実行できる、基本的な機能を備えたアドインが作成されます。アドインウィザードで基本プログラムが生成された後に、コードを追加してカスタマイズできます。

アドインウィザードでは、アドインの表示名および説明を指定できます。両方とも、アドインマネージャーに表示されます。オプションで、アドインを開くコマンドを [ツール] メニューに追加するコードをウィザードで生成することもできます。また、アドインにカスタムの [バージョン情報] ダイアログボックスを表示することもできます。ウィザードが完了すると、アドインを実装するクラスの 1 種類のクラスを含む新しいプロジェクトが作成されます。そのクラスには Connect という名前が付けられます。

このトピックの最後にあるアドインマネージャーを使用します。

詳細については、「アドインおよびウィザードの作成」を参照してください。

アドインウィザードを使用してアドインを作成するには

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

[新しいプロジェクト] ダイアログボックスが表示されます。
[インストールされたテンプレート] で、[その他のプロジェクトの種類] を展開し、[機能拡張] を選択します。
テンプレートリストで、[Visual Studio アドイン] を選択します。
[名前] にアドインの名前を入力します。例: WebPerfTestResultsViewerAddin
[OK] をクリックします。

Visual Studio アドインウィザードが起動します。
[次へ] をクリックします。
[プログラミング言語の選択] ページで、アドインを記述するのに使用するプログラミング言語を選択します。

[!メモ]

このトピックでは、サンプルコードの実行に Visual C# を使用します。
[アプリケーションホストの選択] のページのの Visual Studio および明示的な [Visual Studio Macros]。
[次へ] をクリックします。
[名前および説明の入力] ページで、アドインの名前および説明を入力します。

アドインが作成されると、アドインマネージャーの [使用できるアドイン] ボックスの一覧にアドインの名前と説明が表示されます。アドインの機能や動作などをユーザーが理解できる説明をアドインに追加します。
[次へ] をクリックします。
[アドインオプションを選択します。] ページの [ホストアプリケーションの読み込み時にアドインを開始する] をクリックします。
残りのチェックボックスをオフにします。
[[バージョン情報] に関する情報を選択します。] ページで、アドインについての情報を [バージョン情報] ダイアログボックスに表示するかどうかを指定できます。情報を表示したい場合は、[[バージョン情報] ボックスの情報を指定する] チェックボックスをオンにします。

Visual Studio の [バージョン情報] ダイアログボックスに追加できる情報には、バージョン番号、サポートの詳細、ライセンスのデータなどがあります。
[次へ] をクリックします。
選択したオプションが [概要] ページに表示され、選択した内容を確認できます。なければ、アドインを作成するには [完了] を選択します。何かを変更する場合は、[戻る] のボタンをクリックします。

新しいソリューションおよびプロジェクトが作成され、コードエディターに新しいアドインの Connect.cs ファイルが表示されます。

この WebPerfTestResultsViewerAddin プロジェクトによって参照されるユーザーコントロールを作成した後に、コードを Connect.cs ファイルに追加します。

作成したアドインをアドインマネージャーでアクティブ化できるようにするには、アドインを Visual Studio に登録する必要があります。これを行うには、.addin ファイル名拡張子を持つ XML ファイルを使用します。

この XML ファイルには、Visual Studio のアドインマネージャーにアドインを表示するために必要な情報が記述されています。Visual Studio は起動時に、使用できる .addin ファイルを検出するために .addin ファイルの場所を検索します。使用できる .addin ファイルが検出された場合、この XML ファイルをクリックすると、内容が読み取られて、アドインを起動するのに必要な情報がアドインマネージャーに渡されます。

.addin ファイルは、アドインウィザードを使用してアドインを作成すると、自動的に作成されます。

詳細については、「アドインの登録」を参照してください。

アドインファイルの場所

アドインウィザードによって、次のような .addin ファイルのコピーが 2 つ自動的に作成されます。

.Addin ファイルの場所	.Dll ファイルの場所	説明
ルートプロジェクトフォルダー \<ドキュメント>\Visual Studio 11\Projects\MyAddin1\MyAddin1\	ローカルパス (MyAddin1.dll)	アドインプロジェクトの配置に使用します。編集しやすくするためにプロジェクトに含まれており、XCopy 形式の配置用のローカルパスが設定されます。
アドインフォルダー \<ドキュメント>\Visual Studio 11\Addins\ または <共有ドキュメントの場所>\Addins\	プロジェクトデバッグフォルダー (例: \ Documents\Visual Studio 11 Projects\MyAddin1\MyAddin1\bin\)	デバッグ環境でアドインを実行する場合に使用します。常に、現在のビルド構成の出力パスを示します。

ルートプロジェクトフォルダー

\<ドキュメント>\Visual Studio 11\Projects\MyAddin1\MyAddin1\

ローカルパス (MyAddin1.dll)

アドインプロジェクトの配置に使用します。編集しやすくするためにプロジェクトに含まれており、XCopy 形式の配置用のローカルパスが設定されます。

アドインフォルダー

\<ドキュメント>\Visual Studio 11\Addins\

または

<共有ドキュメントの場所>\Addins\

プロジェクトデバッグフォルダー

(例: \ Documents\Visual Studio 11

Projects\MyAddin1\MyAddin1\bin\)

デバッグ環境でアドインを実行する場合に使用します。常に、現在のビルド構成の出力パスを示します。

Windows フォームコントロールライブラリプロジェクトの作成

前の手順で作成された Visual Studio アドインが Windows フォームコントロールライブラリプロジェクトを参照して、UserControl クラスのインスタンスを作成します。

詳細については、「Windows フォームコントロール」を参照してください。

コントロールを作成して Web テスト結果ビューアーで使用するには

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

[新しいプロジェクト] ダイアログボックスが表示されます。
[インストールされたテンプレート] の [Visual Basic] または [Visual C#] のいずれかを展開し、[Windows] を選択します。

[!メモ]

このトピックでは、サンプルコードの実行に Visual C# を使用します。
テンプレートの一覧で、[Windows フォームコントロールライブラリ] を選択します。
[名前] にアドインの名前を入力します。例: WebPerfTestResultsViewerControl
[OK] をクリックします。

Windows フォームコントロールライブラリプロジェクト WebPerfTestResultsViewerControl がソリューションエクスプローラーに追加され、UserControl1.cs がデザインモードで表示されます。
ツールボックスから userControl1 のサーフェイスに DataGridView をドラッグします。
DataGridView の右上隅のアクションタググリフ () をクリックして、次の手順を実行します。
1. [親コンテナーにドッキングする] を選択します。
2. [追加を有効にする]、[編集を有効にする]、[削除を有効にする]、および [列の並べ替えを有効にする] の各チェックボックスをオフにします。
3. [列の追加] を選択します。
  
  [列の追加] ダイアログボックスが表示されます。
4. [種類] ドロップダウンリストの [DataGridViewTextBoxColumn] をクリックします。
5. [ヘッダーテキスト] の「Column1」というテキストを削除します。
6. [追加] をクリックします。
7. [閉じる] をクリックします。
[プロパティ] ウィンドウで、DataGridView の (Name) プロパティを resultControlDataGridView に変更します。
デザインサーフェイスを右クリックし、[コードの表示] をクリックします。

コードエディターに UserControl1.cs ファイルが表示されます。
インスタンス化された UserControl クラスの名前を UserContro1 から resultControl に変更します。
```
namespace WebPerfTestResultsViewerControl
{
    public partial class resultControl : UserControl
    {
        public resultControl()
        {
            InitializeComponent();
        }
```
次の手順では、resultControl クラスを参照する WebPerfTestResultsViewerAddin プロジェクトの Connect.cs ファイルにコードを追加します。

後で、Connect.cs ファイルにいくつかのコードを追加します。

コードを WebPerfTestResultsViewerAddin に追加する

コードを Visual Studio アドインに追加して Web テスト結果ビューアーを展開するには

ソリューションエクスプローラーで、WebPerfTestResultsViewerAddin プロジェクトの [参照設定] ノードを右クリックし、[参照の追加] を選択します。
[参照の追加] のダイアログボックスで、[.NET] のタブをクリックします。
スクロールダウンして、[Microsoft.VisualStudio.QualityTools.WebTestFramework] を選択し、[System.Windows.Forms] をクリックします。
[OK] をクリックします。
再度 [参照設定] ノードを右クリックして、[参照の追加] を選択します。
[参照の追加] のダイアログボックスで、[参照] のタブをクリックします。
[検索対象] のボックスのを選択し、%ProgramFiles%\Microsoft の Visual Studio 11.0\Common7\IDE\PrivateAssemblies に移動し、Microsoft.VisualStudio.QualityTools.LoadTestPackage.dll ファイルを選択します。
[OK] をクリックします。
WebPerfTestResultsViewerAddin プロジェクトノードを右クリックして、[参照の追加] を選択します。
[参照の追加] のダイアログボックスで、[プロジェクト] のタブをクリックします。
[プロジェクト名] の下に、[WebPerfTestResultsViewerControl] プロジェクトを選択し、[OK] を選択します。
Connect.cs ファイルが表示されない場合、ソリューションエクスプローラーで、WebPerfTestResultsViewerAddin プロジェクトの Connect.cs ファイルを右クリックして、[コードの表示] を選択します。

Connect.cs ファイルで、次の Using ステートメントを追加します。

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

Connect.cs ファイルの最下部までスクロールダウンします。Web パフォーマンステスト結果ビューアーの複数のインスタンスが開いている場合は、UserControl の GUID のリストを追加する必要があります。後で、このリストを使用するコードを追加します。

文字列の 2 番目のリストは、後でコード化する OnDiscconection メソッドで使用されます。
```
        private DTE2 _applicationObject;
        private AddIn _addInInstance;

        private Dictionary<Guid, List<UserControl>> m_controls = new Dictionary<Guid, List<UserControl>>();
        private List<string> temporaryFilePaths = new List<string>();
```

Connect.cs ファイルは、IDTExtensibility2 クラスから Connect という名前のクラスをインスタンス化します。また、このファイルには、Visual Studio アドインを実装するいくつかのメソッドが含まれています。メソッドのうちの 1 つは OnConnection メソッドで、アドインが読み込まれている通知を受け取ります。OnConnection メソッドでは、LoadTestPackageExt クラスを使用して、Web パフォーマンステスト結果ビューアー用の機能拡張パッケージを作成します。次のコードを OnConnection メソッドに追加します。

public void OnConnection(object application, ext_ConnectMode connectMode, object addInInst, ref Array custom)
            {
            _applicationObject = (DTE2)application;
            _addInInstance = (AddIn)addInInst;

            // Create a load test packge extensibility class.
            LoadTestPackageExt loadTestPackageExt = _applicationObject.GetObject("Microsoft.VisualStudio.TestTools.LoadTesting.LoadTestPackageExt") as LoadTestPackageExt;

            // Process open windows.
            foreach (WebTestResultViewer webTestResultViewer in loadTestPackageExt.WebTestResultViewerExt.ResultWindows)
            {
                WindowCreated(webTestResultViewer);
            }

            // Create event handlers.
            loadTestPackageExt.WebTestResultViewerExt.WindowCreated += new EventHandler<WebTestResultViewerExt.WindowCreatedEventArgs>(WebTestResultViewerExt_WindowCreated);
            loadTestPackageExt.WebTestResultViewerExt.WindowClosed += new EventHandler<WebTestResultViewerExt.WindowClosedEventArgs>(WebTesResultViewer_WindowClosed);
            loadTestPackageExt.WebTestResultViewerExt.SelectionChanged += new EventHandler<WebTestResultViewerExt.SelectionChangedEventArgs>(WebTestResultViewer_SelectedChanged);
        }

次のコードを接続クラスに追加して、OnConnection メソッドに追加した loadTestPackageExt.WebTestResultViewerExt.WindowCreated イベントハンドラー用、および WebTestResultViewerExt_WindowCreated メソッドで呼び出される WindowCreated メソッド用の WebTestResultViewerExt_WindowCreated メソッドを作成します。

        void WebTestResultViewerExt_WindowCreated(object sender, WebTestResultViewerExt.WindowCreatedEventArgs e)
        {
            // New control added to new result viewer window.
            WindowCreated(e.WebTestResultViewer);
        }

private void WindowCreated(WebTestResultViewer viewer)
        {
            // Instantiate an instance of the resultControl referenced in the WebPerfTestResultsViewerControl project.
            resultControl resultControl = new resultControl();

            // Add to the dictionary of open playback windows.
            System.Diagnostics.Debug.Assert(!m_controls.ContainsKey(viewer.TestResultId));
            List<UserControl> userControls = new List<UserControl>();
            userControls.Add(resultControl);

            // Add Guid to the m_control List to manage Result viewers and controls.
            m_controls.Add(viewer.TestResultId, userControls);

            // Add tabs to the playback control.
            resultControl.Dock = DockStyle.Fill;
            viewer.AddResultPage(new Guid(), "Sample", resultControl);
        }

次のコードを接続クラスに追加して、OnConnection メソッドに追加した loadTestPackageExt.WebTestResultViewerExt.SelectionChanged イベントハンドラー用の WebTestResultViewer_SelectedChanged メソッドを作成します。

        void WebTestResultViewer_SelectedChanged(object sender, WebTestResultViewerExt.SelectionChangedEventArgs e)
        {
            foreach (UserControl userControl in m_controls[e.TestResultId])
            {
                // Update the userControl in each result viewer.
                resultControl resultControl = userControl as resultControl;
                if (resultControl != null)
                    // Call the resultControl's Update method (This will be added in the next procedure).
                    resultControl.Update(e.WebTestRequestResult);
            }
        }

次のコードを接続クラスに追加して、OnConnection メソッドに追加した loadTestPackageExt.WebTestResultViewerExt.WindowClosed のイベントハンドラー用の WebTesResultViewer_WindowClosed メソッドを作成します。
```
        void WebTesResultViewer_WindowClosed(object sender, WebTestResultViewerExt.WindowClosedEventArgs e)
        {
            if (m_controls.ContainsKey(e.WebTestResultViewer.TestResultId))
            {
                m_controls.Remove(e.WebTestResultViewer.TestResultId);
            }
        }
```
Visual Studio アドイン向けのコードが完成したので、Update メソッドを WebPerfTestResultsViewerControl プロジェクトの resultControl に追加する必要があります。

WebPerfTestResultsViewerControl にコードを追加する

詳細については、「Windows フォームコントロール開発の基本概念」を参照してください。

ユーザーコントロールにコードを追加するには

ソリューションエクスプローラーで、WebPerfTestResultsViewerControl プロジェクトノードを右クリックし、[プロパティ] をクリックします。
次に [アプリケーション] のタブをクリックし、[ターゲットフレームワーク] のドロップダウンリストをクリック [.NET Framework 4] を選択し、プロパティを閉じます。

これは、Web パフォーマンステスト結果ビューアーの拡張に必要な DLL 参照をサポートするために必要です。
ソリューションエクスプローラーで、WebPerfTestResultsViewerControl プロジェクトの [参照設定] ノードを右クリックし、[参照の追加] をクリックします。
[参照の追加] ダイアログボックスの [.NET] タブをクリックします。
スクロールダウンして、[Microsoft.VisualStudio.QualityTools.WebTestFramework] を選択します。
[OK] をクリックします。

UserControl1.cs ファイルに、次の Using ステートメントを追加します。

using Microsoft.VisualStudio.TestTools.WebTesting;
using Microsoft.VisualStudio.TestTools.WebTesting.Rules;

Connect.cs ファイルの WebPerfTestResultsViewerAddin WebTestResultViewer_SelectedChanged メソッドから呼び出されて WebTestRequestResult が渡される Update メソッドを追加します。Update メソッドは、WebTestRequestResult のメソッドに渡されるさまざまなプロパティを使用して DataGridView を設定します。

public void Update(WebTestRequestResult WebTestResults)
        {
            // Clear the DataGridView when a request is selected.
            resultControlDataGridView.Rows.Clear();
            // Populate the DataGridControl with properties from the WebTestResults.
            this.resultControlDataGridView.Rows.Add("Request: " + WebTestResults.Request.Url.ToString());
            this.resultControlDataGridView.Rows.Add("Response: " + WebTestResults.Response.ResponseUri.ToString());
            foreach (RuleResult ruleResult in WebTestResults.ExtractionRuleResults)
            {
                this.resultControlDataGridView.Rows.Add("Extraction rule results: " + ruleResult.Message.ToString());
            }
            foreach (RuleResult ruleResult in WebTestResults.ValidationRuleResults)
            {
                this.resultControlDataGridView.Rows.Add("Validation rule results: " + ruleResult.Message.ToString());
            }
            foreach (WebTestError webTestError in WebTestResults.Errors)
            {
                this.resultControlDataGridView.Rows.Add("Error: " + webTestError.ErrorType.ToString() + " " + webTestError.ErrorSubtype.ToString() + " " + webTestError.ExceptionText.ToString());
            }
        }

WebPerfTestResultsViewerAddin ソリューションのビルド

ソリューションをビルドするには

[ビルド] メニューの [ソリューションのビルド] をクリックします。

WebPerfTestResultsViewerAddin アドインの登録

アドインマネージャーを使用してアドインを登録するには

[ツール] メニューの[ [アドインマネージャー]。
[アドインマネージャー] ダイアログボックスが表示されます。
[使用可能なアドイン] 列の WebPerfTestResultsViewerAddin アドイン向けのチェックボックスをオンにして、[スタートアップ] および [コマンドライン] 列の下のチェックボックスをオフにします。
[OK] をクリックします。

詳細については、「方法: アドインマネージャーを使用してアドインを制御する」を参照してください。

WebPerfTestResultsViewerAddin アドインのビルドを使用した Web パフォーマンステストの実行

Web テスト結果ビューアーのための新しい VS アドインを実行するには

Web パフォーマンステストを実行すると、WebPerfTestResultsViewerAddin アドインの「サンプル」というタイトルの新しいタブが Web パフォーマンステスト結果ビューアーに表示されます。
DataGridView にというプロパティを表示するには、タブをクリックします。

セキュリティ

悪質なアドインが自動的にアクティブにならないようにしてセキュリティを強化するために、Visual Studio の [ツール] メニューの [オプション] ページには、[アドイン/マクロセキュリティ] という名前の設定が用意されています。

さらに、このオプションページでは、Visual Studio が .AddIn 登録ファイルを検索するためのフォルダーを指定できます。このようにフォルダーを指定すると、.AddIn 登録ファイルを読み取ることができる場所が制限されるので、セキュリティが強化されます。これにより、悪意のある .AddIn ファイルが誤って使用されるのを防ぐことができます。

アドインのセキュリティ設定

アドインのセキュリティに関連する、「Add-in/Macros Security, Environment, Options Dialog Box」にある設定は次のとおりです。

**読み込むようにアドインコンポーネント。**既定でオンになっています。オンにすると、アドインを Visual Studio で読み込むことができます。オフにすると、アドインを Visual Studio で読み込むことができなくなります。
**アドインコンポーネントが URL から読み込まれるようにします。**既定で選択されていない。オンにすると、アドインは外部 Web サイトから読み込むことができます。オフにすると、リモートアドインは Visual Studio で読み込むことができなくなります。何らかの原因でアドインを読み込むことができない場合は、Web から読み込むこともできません。この設定では、アドイン DLL の読み込みだけが制御されます。.Addin 登録ファイルは、常にローカルシステムに存在する必要があります。
詳細については、「アドインのセキュリティ」を参照してください。

参照

次の方法で共有

方法: Web パフォーマンステスト結果ビューアー用に Visual Studio アドインを作成する

ASP.NET Web アプリケーションおよび Web パフォーマンステストおよびロードテストプロジェクトを含むソリューションを作成または開きます。

Web パフォーマンステスト結果ビューアーの拡張の準備をするには

Visual Studio アドインの作成

アドインウィザードを使用してアドインを作成するには

アドインファイルの場所

Windows フォームコントロールライブラリプロジェクトの作成

コントロールを作成して Web テスト結果ビューアーで使用するには

コードを WebPerfTestResultsViewerAddin に追加する

コードを Visual Studio アドインに追加して Web テスト結果ビューアーを展開するには

WebPerfTestResultsViewerControl にコードを追加する

ユーザーコントロールにコードを追加するには

WebPerfTestResultsViewerAddin ソリューションのビルド

ソリューションをビルドするには

WebPerfTestResultsViewerAddin アドインの登録

アドインマネージャーを使用してアドインを登録するには

WebPerfTestResultsViewerAddin アドインのビルドを使用した Web パフォーマンステストの実行

Web テスト結果ビューアーのための新しい VS アドインを実行するには

セキュリティ

参照

処理手順

関連項目

概念

その他の技術情報

その他のリソース

次の方法で共有

方法: Web パフォーマンス テスト結果ビューアー用に Visual Studio アドインを作成する

ASP.NET Web アプリケーションおよび Web パフォーマンス テストおよびロード テスト プロジェクトを含むソリューションを作成または開きます。

Web パフォーマンス テスト結果ビューアーの拡張の準備をするには

Visual Studio アドインの作成

アドイン ウィザードを使用してアドインを作成するには

アドイン ファイルの場所

Windows フォーム コントロール ライブラリ プロジェクトの作成

コントロールを作成して Web テスト結果ビューアーで使用するには

コードを WebPerfTestResultsViewerAddin に追加する

コードを Visual Studio アドインに追加して Web テスト結果ビューアーを展開するには

WebPerfTestResultsViewerControl にコードを追加する

ユーザー コントロールにコードを追加するには

WebPerfTestResultsViewerAddin ソリューションのビルド

ソリューションをビルドするには

WebPerfTestResultsViewerAddin アドインの登録

アドイン マネージャーを使用してアドインを登録するには

WebPerfTestResultsViewerAddin アドインのビルドを使用した Web パフォーマンス テストの実行

Web テスト結果ビューアーのための新しい VS アドインを実行するには

セキュリティ

参照

処理手順

関連項目

概念

その他の技術情報

その他のリソース

方法: Web パフォーマンステスト結果ビューアー用に Visual Studio アドインを作成する

ASP.NET Web アプリケーションおよび Web パフォーマンステストおよびロードテストプロジェクトを含むソリューションを作成または開きます。

Web パフォーマンステスト結果ビューアーの拡張の準備をするには

アドインウィザードを使用してアドインを作成するには

アドインファイルの場所

Windows フォームコントロールライブラリプロジェクトの作成

ユーザーコントロールにコードを追加するには

アドインマネージャーを使用してアドインを登録するには

WebPerfTestResultsViewerAddin アドインのビルドを使用した Web パフォーマンステストの実行