Classe ExtractionRule

Artigo
05/14/2013

Classe base usada para definir regras para a obtenção de dados de uma resposta da Web que é gerado por um teste de desempenho da Web.

Hierarquia de herança

System.Object
Microsoft.VisualStudio.TestTools.WebTesting.ExtractionRule
Mais...

Namespace: Microsoft.VisualStudio.TestTools.WebTesting
Assembly: Microsoft.VisualStudio.QualityTools.WebTestFramework (em Microsoft.VisualStudio.QualityTools.WebTestFramework.dll)

Sintaxe

'Declaração
Public MustInherit Class ExtractionRule

public abstract class ExtractionRule

public ref class ExtractionRule abstract

[<AbstractClass>]
type ExtractionRule =  class end

public abstract class ExtractionRule

O tipo ExtractionRule expõe os membros a seguir.

Construtores

	Nome	Descrição
	ExtractionRule	Inicializa uma nova instância da classe ExtractionRule.

Superior

Propriedades

	Nome	Descrição
	ContextParameterName	Obtém ou define o nome do contexto da propriedade extraído.
	RuleDescription	Obsoleta. Este método não é mais usado.Use o DisplayNameAttribute na classe para definir uma descrição para esta regra.
	RuleName	Obsoleta. Este método não é mais usado.Use o DisplayNameAttribute na classe para definir um nome de exibição para esta regra.

Superior

Métodos

	Nome	Descrição
	Equals	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
	Extract	Quando substituído em uma classe derivada, este método extrai informações de um HtmlDocument e o coloca na WebTestContext.
	Finalize	Permite que um objeto tentar liberar recursos e realizar outras operações de limpeza antes de ser recuperados pela coleta de lixo. (Herdado de Object.)
	GetHashCode	Serve como uma função de hash para um tipo específico. (Herdado de Object.)
	GetType	Obtém Type da instância atual. (Herdado de Object.)
	MemberwiseClone	Cria uma cópia superficial de Objectatual. (Herdado de Object.)
	ToString	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object.)

Superior

Comentários

O ExtractionRule classe deve ser herdada por qualquer regra de extração, seja ele interno ou escritas pelo usuário.Regras de extração que estão associadas com a definição de solicitação são executadas depois foi recebida uma resposta, e os resultados da extração são adicionados para o WebTestContext.

Observações para herdeiros

Quando você herda de ExtractionRule, você deve substituir os seguintes membros: Extract, RuleDescription, e RuleName.

Exemplos

A regra de extração personalizada a seguir extrai as caixas de seleção da HtmlDocument e coloca o status das caixas de seleção encontrados em contexto.

using System;
using Microsoft.VisualStudio.TestTools.WebTesting;

namespace ClassLibrary2
{
    public class ExtractCheckBoxes : ExtractionRule
    {
        private string myContextParameter = "ExtractCBoxParam";
        private bool isChecked = true;

        public override string ContextParameterName
        {
            get { return myContextParameter; }
            set
            {
                if (value != string.Empty)
                    myContextParameter = value;
            }
        }

        public bool FindCheckedBoxes
        {
            get { return isChecked; }
            set { isChecked = value; }
        }

        public override string RuleName
        {
            get { return "Extract Check Boxes"; }
        }

        public override string RuleDescription
        {
            get { return "Extract check boxes based on whether they are" +
                    " checked or not."; }
        }

        public override void Extract(object sender, ExtractionEventArgs e)
        {   
            e.Success = false;
            
            if (e.Response.HtmlDocument != null)
            {   // Gets all input tags
                foreach (HtmlTag tag in e.Response.HtmlDocument
                    .GetFilteredHtmlTags(new string[] { "input" }))
                {   // Verify that current tag is a checkbox
                    if (tag.GetAttributeValueAsString("type") == "checkbox")
                    {   // Is the checkbox checked
                        if (tag.GetAttributeValueAsString("checked") == "CHECKED")
                        {   // Add checked check boxes to context
                            if (isChecked)
                            {
                                e.WebTest.Context.Add(myContextParameter + "_" +
                                    tag.GetAttributeValueAsString("id"),
                                    "Is Checked");
                                e.Success = true;
                            }
                        }
                        else // The checkbox is not checked
                        {   // Add non-checked boxes to context
                            if (!isChecked)
                            {
                                e.WebTest.Context.Add(myContextParameter + "_" +
                                    tag.GetAttributeValueAsString("id"),
                                    "Is Not Checked");
                                e.Success = true;
                            }
                        }
                    }
                }
            }
            if (e.Success)
                e.Message = "Extracted check boxes.";
            else
                e.Message = "No check boxes extracted.";
        }
    }
}

Imports System
Imports Microsoft.VisualStudio.TestTools.WebTesting

Namespace ClassLibrary2
    Public Class ExtractCheckBoxes
        Inherits ExtractionRule

        Private myContextParameter As String = "ExtractCBoxParam"
        Private isChecked As Boolean = True

        Public Overrides Property ContextParameterName() As String
            Get
                Return myContextParameter
            End Get
            Set(ByVal value As String)
                If (value <> String.Empty) Then
                    myContextParameter = value
                End If
            End Set
        End Property

        Public Property FindCheckedBoxes() As Boolean
            Get
                Return isChecked
            End Get
            Set(ByVal value As Boolean)
                isChecked = value
            End Set
        End Property

        Public Overrides ReadOnly Property RuleName() As String
            Get
                Return "Extract Check Boxes"
            End Get
        End Property

        Public Overrides ReadOnly Property RuleDescription() As String
            Get
                Return "Extract check boxes based on whether they are" + _
                    " checked or not."
            End Get
        End Property

        Public Overrides Sub Extract(ByVal sender As Object, ByVal e As ExtractionEventArgs)
            e.Success = False
            If Not e.Response.HtmlDocument Is Nothing Then
                ' Gets all input tags
                Dim tag As HtmlTag
                For Each tag In e.Response.HtmlDocument.GetFilteredHtmlTags(New String() {"input"})
                    ' Verify if current tag is a checkbox
                    If tag.GetAttributeValueAsString("type") = "checkbox" Then
                        ' Is the check box checked
                        If tag.GetAttributeValueAsString("checked") = "CHECKED" Then
                            ' Add checked checkbox to context
                            If isChecked = True Then
                                e.WebTest.Context.Add(myContextParameter + "_" + _
                                tag.GetAttributeValueAsString("id"), "Is Checked")
                                e.Success = True
                            End If
                        Else ' The check box is not checked
                            If isChecked = False Then
                                ' Add non-checked boxes to context
                                e.WebTest.Context.Add(myContextParameter + "_" + _
                                tag.GetAttributeValueAsString("id"), "Is Not Checked")
                                e.Success = True
                            End If
                        End If
                    End If
                Next
            End If
            If e.Success = True Then
                e.Message = "Extracted check boxes."
            Else
                e.Message = "No check boxes extracted."
            End If
        End Sub
    End Class
End Namespace

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.VisualStudio.TestTools.WebTesting

Outros recursos

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

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

Hierarquia de herança

Compartilhar via

Classe ExtractionRule

Hierarquia de herança

Sintaxe

Construtores

Propriedades

Métodos

Comentários

Exemplos

Acesso thread-safe

Consulte também

Referência

Outros recursos

Hierarquia de herança

Recursos adicionais