次の方法で共有

方法: Web パフォーマンス テスト エディターのカスタム HTTP ボディ エディターを作成する

  • [アーティクル]

Web サービス要求 (たとえば、SOAP、残り、.asmx、wcf、RIA、他の Web サービス要求の型を文字列ボディのコンテンツまたはバイナリ本体の内容編集できるようにするカスタム コンテンツ エディターを作成できます。

実装できるエディターの 2 種類があります:

  • 文字列のコンテンツ エディター は IStringHttpBodyEditorPlugin のインターフェイスを使用してこの実装されます。

  • Binary のコンテンツ エディター は IBinaryHttpBodyEditorPlugin のインターフェイスを使用してこの実装されます。

これらのインターフェイスは、Microsoft.VisualStudio.TestTools.WebTesting 名前空間に含まれます。

要件

  • Visual Studio Ultimate

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

Windows コントロール ライブラリ プロジェクトを使用して、ユーザー コントロールを作成します。

  1. Visual Studio Ultimateでは、[ファイル] で、メニューの [新規作成] を選択し、を選択します。

    [新しいプロジェクト] ダイアログ ボックスが表示されます。

  2. [インストールされたテンプレート] で、使用するプログラミングに応じて [Visual Basic] または [Visual C#] をクリックし、[Windows] を選択します。

    [!メモ]

    このサンプルでは、Visual C# を使用しています。

  3. テンプレートの一覧で、[Windows フォーム コントロール ライブラリ] を選択します。

  4. [名前]ボックスに" "など、MessageEditorsを入力し、[OK] を選択します。

    [!メモ]

    このサンプルでは、MessageEditors を使用しています。

    プロジェクトが新しいソリューションに追加され、UserControl1.cs という名前の UserControl がデザイナーに表示されます。

  5. ツールボックスの [コモン コントロール] カテゴリで、RichTextBox を UserControl1 のサーフェイスにドラッグします。

  6. RichTextBox のコントロールの右上隅のアクション タグ グリフ (スマート タグ グリフ) をクリックし、と [親コンテナーにドッキングする] 選択します。

  7. ソリューション エクスプローラーで、Windows フォーム ライブラリ プロジェクトを右クリックし、[プロパティ] をクリックします。

  8. [プロパティ] の [アプリケーション] タブをクリックします。

  9. [対象とする Framework] ボックスの一覧で、[.NET Framework 4] を選択します。

  10. [対象とする Framework の変更] ダイアログ ボックスが表示されます。

  11. [はい] をクリックします。

  12. ソリューション エクスプローラーで、[参照設定] ノードを右クリックし、[参照の追加] をクリックします。

  13. [参照の追加] ダイアログ ボックスが表示されます。

  14. 選択します。[NET] のタブで、をクリックします [Microsoft.VisualStudio.QualityTools.WebTestFramework] スクロールし、[OK] を選択します。

  15. ソリューション エクスプローラーでビュー デザイナーがまだ開いていない場合は、UserControl1.cs を右クリックし、[デザイナーの表示] をクリックします。

  16. デザイン サーフェイスを右クリックし、[コードの表示] をクリックします。

  17. (省略可能) クラスとコンストラクターの名前を、UserControl1 からわかりやすい名前 (MessageEditorControl など) に変更します。

    [!メモ]

    このサンプルでは、MessageEditorControl を使用しています。

    namespace MessageEditors
{
    public partial class MessageEditorControl : UserControl
    {
        public MessageEditorControl()
        {
            InitializeComponent();
        }
    }
}

  18. 次のプロパティを追加して、RichTextBox1 のテキストを取得および設定できるようにします。IStringHttpBodyEditorPlugin インターフェイスでは EditString を使用し、IBinaryHttpBodyEditorPlugin では EditByteArray を使用します。

            public String EditString
        {
            get
            {
                return this.richTextBox1.Text;
            }
            set
            {
                this.richTextBox1.Text = value;
            }
        }

public byte[] EditByteArray
        {
            get
            {
                return System.Convert.FromBase64String(richTextBox1.Text);
            }
            set
            {
                richTextBox1.Text = System.Convert.ToBase64String(value, 0, value.Length);
            }
        }

Windows コントロール ライブラリ プロジェクトへのクラスの追加

プロジェクトにクラスを追加します。このクラスは IStringHttpBodyEditorPlugin インターフェイスと IBinaryHttpBodyEditorPlugin インターフェイスの実装に使用されます。

この手順でのコードの概要

前の手順で作成した MessageEditorControl UserControl は、messageEditorControl としてインスタンス化されます。

private MessageEditorControl messageEditorControl

messageEditorControl インスタンスは、CreateEditor メソッドによって作成されたプラグイン ダイアログ内でホストされます。また、messageEditorControl の RichTextBox には、IHttpBody のコンテンツが設定されます。ただし、SupportsContentType が true を返さない場合、プラグインの作成を行うことはできません。このエディターの場合、IHttpBody の ContentType に "xml" が含まれているときは、SupportsContentType は true を返します。

文字列ボディの編集が完了し、ユーザーがプラグイン ダイアログ ボックスで [OK] をクリックすると、Web テスト パフォーマンス エディターでは GetNewValue が呼び出されて、編集済みのテキストが文字列として取得され、要求の文字列ボディが更新されます。

クラスを作成して IStringHttpBodyEditorPlugin インターフェイス コードを実装するには

  1. ソリューション エクスプローラーで、Windows フォーム コントロール ライブラリ プロジェクトを右クリックし、[新しい項目の追加] をクリックします。

  2. [新しい項目の追加] ダイアログ ボックスが表示されます。

  3. [クラス] を選択します。

  4. [名前] ボックスに、クラスのわかりやすい名前 (MessageEditorPlugins など) を入力します。

  5. [追加] をクリックします。

    Class1 がプロジェクトに追加され、コード エディターに表示されます。

  6. コード エディターで、次の using ステートメントを追加します。

    using Microsoft.VisualStudio.TestTools.WebTesting;

  7. IStringHttpBodyEditorPlugin インターフェイスから XmlMessageEditor クラスをインスタンス化し、必要なメソッドを実装するために、次のコードを記述またはコピーします。

        /// <summary>
    /// Editor for generic text based hierarchical messages such as XML and JSON.
    /// </summary>
    public class XmlMessageEditor : IStringHttpBodyEditorPlugin
    {
        public XmlMessageEditor()
        {
        }

        /// <summary>
        /// Determine if this plugin supports the content type.
        /// </summary>
        /// <param name="contentType">The content type to test.</param>
        /// <returns>Returns true if the plugin supports the specified content type.</returns>
        public bool SupportsContentType(string contentType)
        {
            return contentType.ToLower().Contains("xml");
        }

        /// <summary>
        /// Create a UserControl to edit the specified bytes.  
        /// This control will be hosted in the
        /// plugin dialog which provides OK and Cancel buttons.
        /// </summary>
        /// <param name="contentType">The content type of the BinaryHttpBody.</param>
        /// <param name="initialValue">The bytes to edit.  The bytes are the payload of a BinaryHttpBody.</param>
        /// <returns>A UserControl capable of displaying and editing the byte array value of the specified content type.</returns>
        public object CreateEditor(string contentType, string initialValue)
        {
            messageEditorControl = new MessageEditorControl();
            messageEditorControl.EditString = initialValue;
            return this.messageEditorControl;
        }

        /// <summary>
        /// Gets the edited bytes after the OK button is clicked on the plugin dialog.
        /// </summary>
        public string GetNewValue()
        {
            return messageEditorControl.EditString;
        }

        private MessageEditorControl messageEditorControl;
    }

クラスへの IBinaryHttpBodyEditorPlugin の追加

IBinaryHttpBodyEditorPlugin インターフェイスを実装します。

この手順でのコードの概要

IBinaryHttpBodyEditorPlugin インターフェイスのコードの実装は、前の手順で説明した IStringHttpBodyEditorPlugin の場合と似ています。ただし、バイナリ バージョンではバイト配列を使用して、文字列の代わりにバイナリ データを処理します。

最初の手順で作成された MessageEditorControl UserControl は、messageEditorControl としてインスタンス化されます。

private MessageEditorControl messageEditorControl

messageEditorControl インスタンスは、CreateEditor メソッドによって作成されたプラグイン ダイアログ内でホストされます。また、messageEditorControl の RichTextBox には、IHttpBody のコンテンツが設定されます。ただし、SupportsContentType が true を返さない場合、プラグインの作成を行うことはできません。このエディターの場合、IHttpBody の ContentType に "msbin1" が含まれているときは、SupportsContentType は true を返します。

文字列ボディの編集が完了し、ユーザーがプラグインのダイアログ ボックスで [OK] をクリックすると、Web テスト パフォーマンス エディターで GetNewValue が呼び出されて、編集済みのテキストが文字列として取得され、要求の BinaryHttpBody.Data が更新されます。

クラスに IBinaryHttpBodyEditorPlugin を追加するには

  • 前の手順で追加された XmlMessageEditor クラスで次のコードを記述またはコピーして、IBinaryHttpBodyEditorPlugin インターフェイスから Msbin1MessageEditor クラスをインスタンス化し、必要なメソッドを実装します。

    /// <summary>
    /// Editor for MSBin1 content type (WCF messages)
    /// </summary>
    public class Msbin1MessageEditor : IBinaryHttpBodyEditorPlugin
    {
        /// <summary>
        /// 
        /// </summary>
        public Msbin1MessageEditor()
        {
        }

        /// <summary>
        /// Determine if this plugin supports a content type.
        /// </summary>
        /// <param name="contentType">The content type to test.</param>
        /// <returns>Returns true if the plugin supports the specified content type.</returns>
        public bool SupportsContentType(string contentType)
        {
            return contentType.ToLower().Contains("msbin1");
        }

        /// <summary>
        /// Create a UserControl to edit the specified bytes.  This control will be hosted in the
        /// plugin dialog which provides OK and Cancel buttons.
        /// </summary>
        /// <param name="contentType">The content type of the BinaryHttpBody.</param>
        /// <param name="initialValue">The bytes to edit.  The bytes are the payload of a BinaryHttpBody.</param>
        /// <returns>A UserControl capable of displaying and editing the byte array value of the specified content type.</returns>
        public object CreateEditor(string contentType, byte[] initialValue)
        {
            messageEditorControl = new MessageEditorControl();
            messageEditorControl.EditByteArray = initialValue;
            return messageEditorControl;
        }

        /// <summary>
        /// Gets the edited bytes after the OK button is clicked on the plugin dialog.
        /// </summary>
        public byte[] GetNewValue()
        {
            return messageEditorControl.EditByteArray;
        }

        private MessageEditorControl messageEditorControl;
        private object originalMessage;
    }

プラグインのビルドおよび配置

IStringHttpBodyEditorPlugin および IBinaryHttpBodyEditorPlugin について生成される dll をビルドおよび配置するには

  1. [ビルド]メニューで、ビルド <Windows Form Control Library project name>"を選択します。

  2. Visual Studio Ultimate を終了します。

    [!メモ]

    dll ファイルがロックされないようにするには、コピーの前に、Visual Studio Ultimate のすべてのインスタンスを終了する必要があります。

  3. プロジェクトの bin\debug フォルダーの生成された .dll ファイル (MessageEditors.dll など) を %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\WebTestPlugins にコピーします。

  4. Visual Studio Ultimate を起動します。

    .dll を Visual Studio Ultimate に登録する必要があります。

Web パフォーマンス テストによるプラグインの検証

プラグインをテストするには

  1. テスト プロジェクトを作成します。

  2. Web パフォーマンス テストを作成し、ブラウザーに Web サービスの URL を入力します。たとえば、http://dev.virtualearth.net/webservices/v1/metadata/searchservice/dev.virtualearth.net.webservices.v1.search.wsdl. などです。

  3. 記録が終了したら、Web パフォーマンス テスト エディターで Web サービスの要求を展開し、[文字列ボディ] または [バイナリ ボディ] を選択します。

  4. [プロパティ]ウィンドウで、文字列ボディ]または[Binary の本体を選択し、省略記号をクリックします (…)。

    [HTTP ボディ データの編集] ダイアログ ボックスが表示されます。

  5. これで、データを編集し、[OK]をクリックできます。これにより、該当する GetNewValue メソッドを起動して、IHttpBody のコンテンツを更新できます。

コードのコンパイル

  • Windows コントロール ライブラリ プロジェクトの対象とするフレームワークを .NET Framework 4.5 であることを確認します。既定では、Windows コントロール ライブラリ プロジェクトは、Microsoft.VisualStudio.QualityTools.WebTestFramework の参照の追加を許可しない .NET Framework 4.5 Client フレームワークを対象とします。

    詳細については、「[アプリケーション] ページ (プロジェクト デザイナー) (C#)」を参照してください。

参照

処理手順

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

方法: Web パフォーマンス テストのカスタム抽出規則を作成する

方法: Web パフォーマンス テストのカスタム検証規則を作成する

方法 : ロード テスト プラグインを作成する

方法: コード化された Web パフォーマンス テストを作成する

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

関連項目

IStringHttpBodyEditorPlugin

CreateEditor

SupportsContentType

GetNewValue

IBinaryHttpBodyEditorPlugin

CreateEditor

SupportsContentType

GetNewValue

IHttpBody

ContentType

UserControl

RichTextBox

その他の技術情報

ロード テストと Web パフォーマンス テストのカスタム プラグインの作成と使用