Cómo: Crear un complemento de nivel de solicitud

Artículo
10/07/2008

Actualización: noviembre 2007

Las solicitudes son las instrucciones declarativas que constituyen las pruebas Web. Los complementos de pruebas web permiten aislar y reutilizar código fuera de las principales instrucciones declarativas de la prueba web. Puede crear complementos y agregarlos a una solicitud individual, así como a la prueba web que la contiene. Un complemento de solicitud personalizado resulta útil para llamar al código cuando una determinada solicitud se ejecuta en una prueba web.

Nota:
En Visual Studio 2005 Team para Testers, era posible crear un complemento de solicitud en el nivel de pruebas que se ejecutara para cada solicitud de la prueba. En Team System 2008 Test, los complementos de nivel de pruebas admiten la interfaz de complemento y se aplican a cada solicitud de la prueba. Cuando Team System 2008 Test encuentra un complemento de solicitud creado en Visual Studio 2005, lo convierte en un complemento de nivel de pruebas equivalente.

En Visual Studio 2005 Team para Testers, era posible crear un complemento de solicitud en el nivel de pruebas que se ejecutara para cada solicitud de la prueba. En Team System 2008 Test, los complementos de nivel de pruebas admiten la interfaz de complemento y se aplican a cada solicitud de la prueba. Cuando Team System 2008 Test encuentra un complemento de solicitud creado en Visual Studio 2005, lo convierte en un complemento de nivel de pruebas equivalente.

Cada complemento de solicitud de pruebas web tiene un método PreRequest y un método PostRequest. Después de asociar un complemento de solicitud a una solicitud HTTP determinada, se desencadenará el evento PreRequest antes de que se emita la solicitud y se desencadenará PostRequest una vez recibida la respuesta.

Para crear un complemento de solicitud de pruebas web personalizado, derive su propia clase de la clase base WebTestRequestPlugin.

Puede utilizar complementos de solicitud de pruebas Web personalizados con las pruebas web que haya registrado. Los complementos de solicitud de pruebas web personalizados permiten escribir una cantidad mínima de código para obtener mayor control sobre sus pruebas web. Aunque también puede utilizarlos con pruebas Web codificadas. Para obtener más información, vea Cómo: Crear una prueba Web codificada.

Para crear un complemento de nivel de solicitud

Abra un proyecto de prueba que contenga una prueba web.

Para obtener más información acerca de cómo crear un proyecto de prueba, vea Cómo: Crear un proyecto de pruebas.
En la misma solución, cree un proyecto de biblioteca de clases para almacenar su complemento de solicitud.
Seleccione el nuevo proyecto de biblioteca de clases y, a continuación, haga clic con el botón secundario del mouse en Agregar referencia.
En la ficha .NET, seleccione Microsoft.VisualStudio.QualityTools.WebTestFramework. Haga clic en Aceptar.
En su proyecto de prueba, haga clic con el botón secundario del mouse y seleccione Agregar referencia.
En la ficha Proyectos, seleccione el nuevo proyecto de biblioteca de clases. Haga clic en Aceptar.
Escriba el código del complemento. En primer lugar, cree una clase pública derivada de WebTestRequestPlugin.
Implemente el código dentro de uno de los controladores de eventos PreRequest y PostRequest o en ambos.
Cuando haya terminado de escribir el código, genere el nuevo proyecto.
Abra la prueba Web a la que desea agregar el complemento de la solicitud.
Haga clic con el botón secundario del mouse en la solicitud a la que desea agregar el complemento y, a continuación, seleccione Agregar complemento de solicitud.

Se muestra el cuadro de diálogo Agregar complemento de solicitudes de prueba web.
En Seleccionar un complemento, seleccione su nuevo complemento y, a continuación, haga clic en Aceptar.

El complemento se agrega a la carpeta Complementos de solicitud, que es una carpeta secundaria de la solicitud HTTP.

Ejemplo

Puede utilizar el código siguiente para crear un complemento de pruebas web personalizado.

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