Como: Criar uma regra de extração personalizada para um teste de desempenho de Web

Este tópico se aplica a:

Visual Studio Ultimate

Visual Studio Premium

Visual Studio Professional 

Visual StudioExpress

O tópico é aplicável O tópico não é aplicável O tópico não é aplicável O tópico não é aplicável

Você pode criar suas próprias regras de extração. Para fazer isso, você deriva suas próprias regras de uma classe regra. Regras de extração derivam de ExtractionRule classe de base.

Visual Studio Ultimatefornece algumas regras de extração predefinidas. Para obter mais informações, consulte Usando o Validation and Extraction Rules nos testes de desempenho de Web.

ObservaçãoObservação

Você também pode criar regras de validação personalizadas. Para obter mais informações, consulte Criar e usar o Custom Plug-ins para carga e testes de desempenho de Web.

Para criar uma regra de extração personalizada

  1. Abra um projeto de teste que contém um teste de desempenho da Web.

  2. (Opcional) Crie um projeto de biblioteca de classe separado para armazenar sua regra de extração.

    Observação importanteImportante

    Você pode criar a classe no mesmo projeto em que os testes estão em. No entanto, se você deseja reutilizar a regra, é melhor criar um projeto de biblioteca de classe separado para armazenar sua regra. Se você criar um projeto separado, conclua as etapas opcionais neste procedimento.

  3. (Opcional) No projeto de biblioteca de classe, adicione uma referência para a dll de Microsoft.VisualStudio.QualityTools.WebTestFramework.

  4. Criar uma classe que deriva do ExtractionRule classe. Implementar a Extract e RuleName membros.

  5. (Opcional) Crie um novo projeto de biblioteca de classe.

  6. (Opcional) No projeto de teste, adicione uma referência ao projeto de biblioteca de classe que contém a regra de extração personalizada.

  7. No Test Project, abra um teste de desempenho na Web a Editor do teste de desempenho do Web.

  8. Para adicionar a regra de extração personalizada, uma solicitação de teste de desempenho da Web com o botão direito e selecione Add Extraction Rule.

    O Add Extraction Rule caixa de diálogo aparece. Você verá sua regra de validação personalizada no Selecionar uma regra lista, juntamente com as regras de validação predefinidas. Selecione a regra de extração personalizada e clique OK.

  9. Execute o teste de desempenho de Web.

Exemplo

O código a seguir mostra uma implementação de uma regra de extração personalizada. A regra de extração extrai o valor de um campo de entrada especificado. Use este exemplo como ponto de partida para suas próprias regras de extração personalizada.

using System;
using System.Collections.Generic;
using Microsoft.VisualStudio.TestTools.WebTesting;
using System.Globalization;

namespace ClassLibrary2
{
    //-------------------------------------------------------------------------
    // This class creates a custom extraction rule named "Custom Extract Input"
    // The user of the rule specifies the name of an input field, and the
    // rule attempts to extract the value of that input field.
    //-------------------------------------------------------------------------
    public class CustomExtractInput : ExtractionRule
    {
        /// Specify a name for use in the user interface.
        /// The user sees this name in the Add Extraction dialog box.
        //---------------------------------------------------------------------
        public override string RuleName
        {
            get { return "Custom Extract Input"; }
        }

        /// Specify a description for use in the user interface.
        /// The user sees this description in the Add Extraction dialog box.
        //---------------------------------------------------------------------
        public override string RuleDescription
        {
            get { return "Extracts the value from a specified input field"; }
        }

        // The name of the desired input field
        private string NameValue;
        public string Name
        {
            get { return NameValue; }
            set { NameValue = value; }
        }

        // The Extract method.  The parameter e contains the web performance test context.
        //---------------------------------------------------------------------
        public override void Extract(object sender, ExtractionEventArgs e)
        {
            if (e.Response.HtmlDocument != null)
            {
                foreach (HtmlTag tag in e.Response.HtmlDocument.GetFilteredHtmlTags(new string[] { "input" }))
                {
                    if (String.Equals(tag.GetAttributeValueAsString("name"), Name, StringComparison.InvariantCultureIgnoreCase))
                    {
                        string formFieldValue = tag.GetAttributeValueAsString("value");
                        if (formFieldValue == null)
                        {
                            formFieldValue = String.Empty;
                        }

                        // add the extracted value to the web performance test context
                        e.WebTest.Context.Add(this.ContextParameterName, formFieldValue);
                        e.Success = true;
                        return;
                    }
                }
            }
            // If the extraction fails, set the error text that the user sees
            e.Success = false;
            e.Message = String.Format(CultureInfo.CurrentCulture, "Not Found: {0}", Name);
        }
    }
}
Imports System
Imports System.Collections.Generic
Imports Microsoft.VisualStudio.TestTools.WebTesting
Imports System.Globalization

Namespace ClassLibrary2

    '-------------------------------------------------------------------------
    ' This class creates a custom extraction rule named "Custom Extract Input"
    ' The user of the rule specifies the name of an input field, and the
    ' rule attempts to extract the value of that input field.
    '-------------------------------------------------------------------------
    Public Class CustomExtractInput
        Inherits ExtractionRule

        ' Specify a name for use in the user interface.
        ' The user sees this name in the Add Extraction dialog box.
        '---------------------------------------------------------------------
        Public Overrides ReadOnly Property RuleName() As String
            Get
                Return "Custom Extract Input"
            End Get
        End Property

        ' Specify a description for use in the user interface.
        ' The user sees this description in the Add Extraction dialog box.
        '---------------------------------------------------------------------
        Public Overrides ReadOnly Property RuleDescription() As String
            Get
                Return "Extracts the value from a specified input field"
            End Get
        End Property

        ' The name of the desired input field
        Private NameValue As String
        Public Property Name() As String
            Get
                Return NameValue
            End Get
            Set(ByVal value As String)
                NameValue = value
            End Set
        End Property

        ' The Extract method.  The parameter e contains the web performance test context.
        '---------------------------------------------------------------------
        Public Overrides Sub Extract(ByVal sender As Object, ByVal e As ExtractionEventArgs)

            If Not e.Response.HtmlDocument Is Nothing Then

                For Each tag As HtmlTag In e.Response.HtmlDocument.GetFilteredHtmlTags(New String() {"input"})

                    If String.Equals(tag.GetAttributeValueAsString("name"), Name, StringComparison.InvariantCultureIgnoreCase) Then

                        Dim formFieldValue As String = tag.GetAttributeValueAsString("value")
                        If formFieldValue Is Nothing Then

                            formFieldValue = String.Empty
                        End If

                        ' add the extracted value to the web performance test context
                        e.WebTest.Context.Add(Me.ContextParameterName, formFieldValue)
                        e.Success = True
                        Return
                    End If
                Next
            End If
            ' If the extraction fails, set the error text that the user sees
            e.Success = False
            e.Message = String.Format(CultureInfo.CurrentCulture, "Not Found: {0}", Name)
        End Sub
    End Class
end namespace

O Extract método contém a funcionalidade central de uma regra de extração. O Extract método no exemplo anterior usa um ExtractionEventArgs que fornece a resposta gerada pela solicitação este tampas de regra de extração. A resposta contém um HtmlDocument que contém todas as marcas na resposta. Marcas de entrada são filtradas fora das HtmlDocument. Cada marca de entrada é examinada para um atributo chamado nome cujo valor é igual a do usuário fornecido pelo valor de nome propriedade. Se uma marca com esse atributo correspondente for encontrada, é feita uma tentativa para extrair um valor que está contido no valor de atributo, se existe um atributo de valor. Se ele existir, o nome e o valor da marca são extraídos e adicionados ao contexto do teste de desempenho da web. O regra de extração passa.

Consulte também

Tarefas

Como: Adicionar uma regra de extração a um teste de desempenho da Web

Demonstra Passo a passo: Adicionando Validation and Extraction Rules para um teste de desempenho da Web

Como: Criar uma regra de validação personalizada para um teste de desempenho de Web

Referência

ExtractionRule

Microsoft.VisualStudio.TestTools.WebTesting.Rules

ExtractAttributeValue

ExtractFormField

ExtractHttpHeader

ExtractRegularExpression

ExtractText

ExtractHiddenFields

Conceitos

Usando o Validation and Extraction Rules nos testes de desempenho de Web