Jak: vytvoření vlastní HTTP subjekt Editor pro Editor webové Test výkonu

Článek
03/12/2013

Můžete vytvořit vlastní editor obsahu, který umožňuje upravovat obsah řetězce text nebo binární subjekt obsah požadavek webové služby, například SOAP, odpočinek, asmx, wcf RIA a jiných typů požadavků webové služby.

Existují dva typy editorů, které mohou implementovat:

Editor řetězce obsahu je toto chování implementováno pomocí IStringHttpBodyEditorPlugin rozhraní.
Binární editor obsahu je toto chování implementováno pomocí IBinaryHttpBodyEditorPlugin rozhraní.

Tato rozhraní jsou obsaženy v Microsoft.VisualStudio.TestTools.WebTesting oboru názvů.

Požadavky

Visual Studio Ultimate

Vytvoření projektu knihovny ovládacích prvků Windows

Vytvořit uživatelský ovládací prvek pomocí projektu knihovny ovládacích prvků Windows

V Visual Studio Ultimatedále soubor nabídce zvolte Nový a potom vyberte projektu.

Zobrazí se dialogové okno Nový projekt.
Podle Nainstalované šablony, vyberte buď jazyka Visual Basic nebo Visual C# závislosti na vašich preferencích programování a pak vyberte volbu Windows.

[!POZNÁMKA]

Tento příklad používá Visual C#.
V seznamu šablon vyberte Knihovna ovládacích prvků model Windows Forms.
Do textového pole Název zadejte název, například MessageEditorsa zvolte OK.

[!POZNÁMKA]

V tomto příkladu MessageEditors.

Projekt je přidán do nové řešení a UserControl s názvem UserControl1.cs je zobrazen v návrháři.
Z nástrojů, v oblasti Běžné ovládací prvky kategorie, přetáhněte RichTextBox na povrch UserControl1.
Zvolte piktogram akce () v pravém horním rohu RichTextBox ovládací prvek a potom vybrat a Ukotvit v nadřazeném kontejneru.
V okně Průzkumník řešení klikněte pravým tlačítkem myši projektu model Windows Forms knihovny a vyberte Vlastnosti.
V dialogovém okně Vlastnosti, vyberte aplikace kartu.
V cílové rozhraní rozevíracího seznamu vyberte rozhraní.NET Framework 4.
Zobrazí se dialogové okno Změnit cílový rámec.
Zvolte Ano.
V okně Průzkumník řešení klikněte pravým tlačítkem myši odkazy uzlu a vyberte Přidat odkaz na.
Zobrazí se dialogové okno Přidat odkaz.
Zvolte. NET karta, přejděte dolů a vyberte Microsoft.VisualStudio.QualityTools.WebTestFramework a pak zvolte OK.
Pokud Návrhář zobrazení je stále otevřen v okně Průzkumník řešení, klepněte pravým tlačítkem UserControl1.cs a potom vyberte Návrhář zobrazení.
Na návrhové ploše, klikněte pravým tlačítkem myši a vyberte Zobrazit kód.

(Volitelné) Změňte název třídy a konstruktoru z UserControl1 smysluplný název, například MessageEditorControl:

[!POZNÁMKA]

Příklad používá MessageEditorControl.

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

Přidejte následující vlastnosti umožňující získání a nastavení textu v RichTextBox1.IStringHttpBodyEditorPlugin Rozhraní pomocí EditString a IBinaryHttpBodyEditorPlugin EditByteArray použije:

        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);
            }
        }

Přidání třídy pro projekt Knihovna ovládacích prvků systému Windows

Přidání třídy do projektu.Se použije k provedení IStringHttpBodyEditorPlugin a IBinaryHttpBodyEditorPlugin rozhraní.

Přehled kódu v tomto postupu

MessageEditorControl UserControl který byl vytvořen v předchozí proceduře je vytvořena jako messageEditorControl:

private MessageEditorControl messageEditorControl

V dialogovém okně modulu plug-in, který je vytvořen pomocí je hostitelem messageEditorControl instance CreateEditor metoda.Kromě toho messageEditorControl na RichTextBox je naplněn obsah IHttpBody.Vytvoření modulu plug-in nelze však dojít, pokud není SupportsContentType vrátí true.V případě tohoto editoru SupportsContentType vrátí true -li ContentType v IHttpBody obsahuje "xml".

Po dokončení úprav řetězec subjektu a kliknutí uživatele OK v dialogovém okně modulu plug-in GetNewValue je volána pro získání upravený text jako řetězec a aktualizace Řetězec textu v požadavku v editoru výkonu testovací Web.

Chcete-li vytvořit třídu a implementovat rozhraní kód IStringHttpBodyEditorPlugin

V okně Průzkumník řešení klikněte pravým tlačítkem myši na projekt Knihovna ovládacích prvků model Windows Forms a vyberte Přidat novou položku.
Zobrazí se dialogové okno Přidat novou položku.
Vyberte třídy.
V název text zadejte smysluplný název třídy, například MessageEditorPlugins.
Zvolte možnost Přidat.

Class1 je přidána do projektu a předkládány v editoru kódu.
V editoru kódu přidejte následující pomocí příkazu:
```
using Microsoft.VisualStudio.TestTools.WebTesting;
```

Napište nebo zkopírujte následující kód k vytvoření instance třídy XmlMessageEditor z IStringHttpBodyEditorPlugin rozhraní a zavést požadované metody:

    /// <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;
    }

Do třídy přidat IBinaryHttpBodyEditorPlugin

Implementovat rozhraní IBinaryHttpBodyEditorPlugin.

Přehled kódu v tomto postupu

Provádění kódu IBinaryHttpBodyEditorPlugin rozhraní je podobný IStringHttpBodyEditorPlugin zahrnuté v předchozí proceduře.Binární verze však používá pole bajtů zpracovat binární data namísto řetězce.

MessageEditorControl UserControl vytvořené v prvním postupu je vytvořena jako messageEditorControl:

private MessageEditorControl messageEditorControl

Po dokončení úprav řetězec subjektu a kliknutí uživatele OK v dialogovém okně modulu plug-in GetNewValue je volána pro získání upravený text jako řetězec a aktualizace BinaryHttpBody.Data v požadavku v editoru výkonu testovací Web.

Chcete-li přidat IBinaryHttpBodyEditorPlugin do třídy

Napište nebo zkopírujte následující kód ve třídě XmlMessageEditor přidali v předchozím postupu k vytvoření instance třídy Msbin1MessageEditor z IBinaryHttpBodyEditorPlugin rozhraní a zavést požadované metody:

/// <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;
    }

Vytvářejte a nasazujte Plug-Ins

Chcete-li vytvářet a zavádět výsledné knihovny dll pro IStringHttpBodyEditorPlugin a IBinaryHttpBodyEditorPlugin

V nabídce Build zvolte sestavení < název projektu knihovny ovládacích prvků formulářů Windows >.
Ukončete Visual Studio Ultimate.

[!POZNÁMKA]

Je třeba ukončit všechny instance Visual Studio Ultimate Chcete-li zajistit, že soubor knihovny dll není zamknutá před zkopírováním.
Zkopírujte výsledný soubor DLL ze složky bin\debug projekty (například MessageEditors.dll) do %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\WebTestPlugins.
Spusťte nástroj Visual Studio Ultimate.

Soubor knihovny DLL mají být registrovány s Visual Studio Ultimate.

Zkontrolujte moduly pomocí testu výkonu webu

Chcete-li otestovat plug-ins

Vytvořte projekt testů.
Vytvořte Web výkon testování a zadejte adresu URL v prohlížeči webové služby, například http://dev.virtualearth.NET/WebServices/V1/metadata/searchservice/dev.virtualearth.NET.WebServices.v1.Search.WSDL.
Po dokončení nahrávání v Web výkon Test editoru, rozbalte položku požadavek webové služby a vyberte buď Řetězec textu nebo Binární tělo.
V okně Vlastnosti vyberte řetězec text nebo binární subjektu a zvolte tři tečky (...).

Upravit Data tělo HTTP zobrazí dialogové okno.
Nyní můžete upravovat data a klepněte na tlačítko OK.Tím se spustí použitelné metody GetNewValue Chcete-li aktualizovat obsah IHttpBody.

Probíhá kompilace kódu

Ověřte, zda Targeted rámec pro projekt Knihovna ovládacích prvků systému Windows 4.5 rozhraní .NET Framework.Ve výchozím nastavení cíl projektů knihovny ovládacího prvku Windows .NET Framework 4.5 klienta rámec, který neumožní zařazení odkazu na Microsoft.VisualStudio.QualityTools.WebTestFramework.

Další informace naleznete v tématu Stránce aplikace Project Designer (C#).

Viz také

Sdílet prostřednictvím