Gewusst wie: Erstellen eines Anforderungsebenen-Plug-Ins

Artikel
09/02/2008

Aktualisiert: November 2007

Anforderungen sind die deklarativen Anweisungen, aus denen Webtests bestehen. Webtest-Plug-Ins ermöglichen es Ihnen, Code außerhalb der Hauptdeklarationen des Webtests zu isolieren und wiederzuverwenden. Sie können Plug-Ins erstellen und sie einer individuellen Anforderung sowie dem Webtest hinzufügen, in dem sie enthalten ist. Mit einem benutzerdefinierten Anforderungs-Plug-In haben Sie die Möglichkeit, Code aufzurufen, während eine bestimmte Anforderung in einem Webtest ausgeführt wird.

Hinweis:
In Visual Studio 2005 Team Edition for Testers war es möglich, ein Anforderungs-Plug-In auf Testebene zu erstellen, das für jede Anforderung im Test ausgeführt wurde. In Team System 2008 Test Edition unterstützen Plug-Ins auf Testebene die Schnittstelle des Anforderungs-Plug-Ins und werden auf jede Anforderung im Test angewendet. Wenn Team System 2008 Test Edition ein in Visual Studio 2005 erstelltes Anforderungs-Plug-In findet, wird das Plug-In in ein entsprechendes Plug-In auf Testebene konvertiert.

In Visual Studio 2005 Team Edition for Testers war es möglich, ein Anforderungs-Plug-In auf Testebene zu erstellen, das für jede Anforderung im Test ausgeführt wurde. In Team System 2008 Test Edition unterstützen Plug-Ins auf Testebene die Schnittstelle des Anforderungs-Plug-Ins und werden auf jede Anforderung im Test angewendet. Wenn Team System 2008 Test Edition ein in Visual Studio 2005 erstelltes Anforderungs-Plug-In findet, wird das Plug-In in ein entsprechendes Plug-In auf Testebene konvertiert.

Jedes Webtestanforderungs-Plug-In verfügt über eine PreRequest-Methode und eine PostRequest-Methode. Nachdem Sie ein Anforderungs-Plug-In an eine bestimmte HTTP-Anforderung angefügt haben, wird das PreRequest-Ereignis noch vor Senden der Anforderung ausgelöst und das PostRequest-Ereignis nach dem Empfangen der Antwort.

Sie können ein benutzerdefiniertes Webtestanforderungs-Plug-In erstellen, indem Sie die eigene Klasse von der WebTestRequestPlugin-Basisklasse ableiten.

Sie können benutzerdefinierte Webtestanforderungs-Plug-Ins mit den aufgezeichneten Webtests verwenden. Durch benutzerdefinierte Webtestanforderungs-Plug-Ins können Sie nur eine minimale Menge Code erstellen, um eine größere Kontrolle über Ihre Webtests zu erhalten. Sie können die Plug-Ins jedoch auch mit codierten Webtests verwenden. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines codierten Webtests.

So erstellen Sie ein Anforderungsebenen-Plug-In

Öffnen Sie ein Testprojekt, das einen Webtest enthält.

Weitere Informationen zum Erstellen eines Testprojekts finden Sie unter Gewusst wie: Erstellen eines Testprojekts.
Erstellen Sie in derselben Projektmappe ein Klassenbibliotheksprojekt, in dem das Anforderungs-Plug-In gespeichert wird.
Wählen Sie das Klassenbibliotheksprojekt aus, und klicken Sie dann mit der rechten Maustaste auf Verweis hinzufügen.
Wählen Sie auf der Registerkarte .NET die Option Microsoft.VisualStudio.QualityTools.WebTestFramework aus, und klicken Sie auf OK.
Klicken Sie im Testprojekt mit der rechten Maustaste, und wählen Sie Verweis hinzufügen aus.
Wählen Sie auf der Registerkarte Projekte das neue Klassenbibliotheksprojekt aus. Klicken Sie auf OK.
Schreiben Sie den Code für das Plug-In. Erstellen Sie zunächst eine neue, öffentliche Klasse, die von WebTestRequestPlugin abgeleitet wird.
Implementieren Sie Code innerhalb eines oder beider Ereignishandler PreRequest und PostRequest.
Nachdem Sie den Code verfasst haben, erstellen Sie das neue Projekt.
Öffnen Sie den Webtest, dem Sie das Anforderungs-Plug-In hinzufügen möchten.
Klicken Sie mit der rechten Maustaste auf die Anforderung, der Sie das Plug-In hinzufügen möchten, und wählen Sie dann Anforderungs-Plug-In hinzufügen aus.

Das Dialogfeld Webtestanforderungs-Plug-In hinzufügen wird angezeigt.
Wählen Sie unter Plug-In auswählen das neue Plug-In aus, und klicken Sie dann auf OK.

Das Plug-In wird dem Ordner Anforderungs-Plug-Ins hinzugefügt, der ein untergeordneter Ordner der HTTP-Anforderung ist.

Beispiel

Sie können den folgenden Code verwenden, um ein benutzerdefiniertes Webtest-Plug-In zu erstellen.

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