Como criar um plug-in de nível de solicitação

Artigo
06/10/2015

Solicitações são as instruções declarativas que constituem testes de desempenho na Web. Plug-ins de teste de desempenho na Web permitem isolar e reutilizar o código fora das instruções declarativas principais no teste de desempenho na Web. Você pode criar plug-ins e adicioná-los a uma solicitação individual, bem como ao teste de desempenho na Web que a contém. Um plug-in de solicitação personalizado oferece uma maneira de chamar um código quando uma solicitação específica é executada em um teste de desempenho na Web.

Cada plug-in de solicitação de teste de desempenho na Web tem um método PreRequest e um método PostRequest. Depois de anexar um plug-in de solicitação a uma solicitação HTTP específica, o evento PreRequest será acionado antes de a solicitação ser emitido, e o PostRequest é acionado depois que a resposta é recebida.

Você pode criar um plug-in de solicitação de teste de desempenho na Web personalizado com sua própria classe a partir da classe base WebTestRequestPlugin.

Você pode usar plug-ins personalizados de solicitação de teste de desempenho na Web com os testes de desempenho na Web que você gravou. Os plug-ins personalizados de solicitação de teste de desempenho na Web permitem escrever uma quantidade mínima de código para alcançar um nível de maior controle sobre os testes de desempenho na Web. No entanto, também é possível usá-los com testes de desempenho na Web codificados. Para obter mais informações, consulte [obsoleto] Como criar um teste de desempenho na Web codificado.

Requisitos

Visual Studio Ultimate

Para criar um plug-in de solicitação

No Gerenciador de Soluções, clique com o botão direito do mouse na solução, selecione Adicionar e escolha Novo Projeto.

A caixa de diálogo Adicionar Novo Projeto é exibida.
Em Modelos Instalados, selecione Visual C#.
Na lista de modelos, selecione Biblioteca de Classes.
Na caixa de texto Nome, digite um nome para a classe e escolha OK.

O novo projeto da biblioteca de classes é adicionado ao Gerenciador de Soluções e a nova classe é exibida no Editor de Códigos.
No Gerenciador de Soluções, clique com o botão direito na pasta Referências da nova biblioteca de classes e selecione Adicionar Referência.

A caixa de diálogo Adicionar Referência é exibida.
Escolha a guia .NET, role para baixo, selecione Microsoft.VisualStudio.QualityTools.WebTestFramework e clique em OK

A referência para Microsoft.VisualStudio.QualityTools.WebTestFramework é adicionada à pasta Referência do Gerenciador de Soluções.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó superior do projeto de teste de carga e desempenho na Web que contém o teste de carga a que você deseja adicionar o plug-in de solicitação teste de desempenho na Web. Selecione Adicionar Referência.

A caixa de diálogo Adicionar Referência é exibida.
Escolha a guia Projetos, selecione o projeto da biblioteca de classes e escolha OK.
No Editor de Códigos, escreva o código de seu plug-in. Primeiro, crie uma nova classe pública que derive de WebTestRequestPlugin.
Implemente o código dentro de um dos manipuladores de eventos PreRequest e PostRequest. Consulte a seção Exemplo a seguir para obter uma implementação de exemplo.
Depois de gravar o código, compile o novo projeto.
Abra o teste de desempenho na Web ao qual deseja adicionar o plug-in de solicitação.
Clique com o botão direito do mouse na solicitação à qual você deseja adicionar o plug-in de solicitação e selecione Adicionar plug-in de solicitações.

A caixa de diálogo Adicionar plug-in de solicitação de teste na Web é exibida.
Em Selecionar um plug-in, selecione o novo plug-in.
No painel Propriedades do plug-in selecionado, defina os valores iniciais a serem usados pelo plug-in em tempo de execução.

Dica

Você pode expor quantas propriedades quiser de seus plug-ins; apenas torne-os públicos, definíveis e de um tipo de base como Inteiro, Booliano ou Cadeia de Caracteres.Você também pode alterar as propriedades de plug-in de teste de desempenho na Web mais tarde usando a janela Propriedades.
Escolha OK.

O plug-in é adicionado à pasta Plug-ins de solicitação, que é uma pasta filho da solicitação HTTP.
Aviso

Você talvez receba um erro semelhante ao seguinte quando executar um teste de desempenho na Web ou um teste de carga usando seu plug-in:

Request failed: Exception in <plug-in> event: Could not load file or assembly '<"Plug-in name".dll file>, Version=<n.n.n.n>, Culture=neutral, PublicKeyToken=null' or one of its dependencies.The system cannot find the file specified.

Isso será causado se você fizer alterações no código de qualquer um de seus plug-ins e criar uma nova versão de DLL (Version=0.0.0.0), mas o plug-in ainda estiver referenciando a versão original do plug-in.Para corrigir esse problema, siga estas etapas:
1. Em seu projeto de teste de carga e desempenho na Web, você verá um aviso em referências.Remova e adicione novamente a referência à DLL do plug-in.
2. Remova o plug-in do teste ou do local apropriado e adicione-o de volta.

Exemplo

Você pode usar o seguinte código para criar um plug-in personalizado de teste de desempenho na Web que exibe duas caixas de diálogo. Na caixa de diálogo é exibida a URL associada à solicitação à qual você anexa o suplemento de solicitação. A segunda caixa de diálogo exibe o nome do computador para o agente.

Dica

O código a seguir exige que você adicione uma referência a System.Windows.Forms.

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

namespace RequestPluginNamespace
{
    public class MyWebRequestPlugin : WebTestRequestPlugin
    {
        public override void PostRequest(object sender, PostRequestEventArgs e)
        {
            MessageBox.Show(e.WebTest.Context.AgentName);
        }
        public override void PreRequest(object sender, PreRequestEventArgs e)
        {
            MessageBox.Show(e.Request.Url);
        }
    }
}

Consulte também

Partilhar via

Como criar um plug-in de nível de solicitação

Para criar um plug-in de solicitação

Exemplo

Consulte também

Tarefas

Referência

Outros recursos

Recursos adicionais