Gewusst wie: Erstellen einer benutzerdefinierten Validierungsregel
Aktualisiert: November 2007
Sie können eigene Validierungsregeln erstellen. Dazu leiten Sie Ihre eigene Regelklasse von einer Validierungsregelklasse ab. Validierungsregeln werden von der ValidationRule-Basisklasse abgeleitet.
stellt einige vordefinierte Validierungsregeln bereit. Weitere Informationen finden Sie unter Validierungsregeln.
.gif "Hinweis") Hinweis: |
|---|
Sie können auch benutzerdefinierte Extraktionsregeln erstellen. Weitere Informationen finden Sie unter Extraktionsregeln. |
So erstellen Sie benutzerdefinierte Validierungsregeln
Öffnen Sie einen Testprojekt, das einen Webtest enthält.
(Optional) Erstellen Sie ein separates Klassenbibliotheksprojekt, in dem die Validierungsregel gespeichert wird.
.gif "Wichtiger Hinweis")
Wichtiger Hinweis:Die Klasse kann im selben Projekt erstellt werden, in dem sich die Tests befinden. Wenn die Regel erneut verwendet werden soll, wird jedoch empfohlen, ein separates Klassenbibliotheksprojekt zu erstellen, in dem die Regel gespeichert wird. Wenn Sie ein separates Projekt erstellen, müssen Sie die optionalen Schritte in dieser Prozedur ausführen.
(Optional) Fügen Sie im Klassenbibliotheksprojekt einen Verweis auf Microsoft.VisualStudio.QualityTools.WebTestFramework DLL ein.
Erstellen Sie eine von der ValidationRule-Klasse abgeleitete Klasse. Implementieren Sie den Validate-Member und den RuleName-Member.
(Optional) Erstellen Sie das neue Klassenbibliotheksprojekt.
(Optional) Fügen Sie im Testprojekt einen Verweis auf das Klassenbibliotheksprojekt mit der benutzerdefinierten Validierungsregel hinzu.
Öffnen Sie im Webtest-Editor des Testprojekts einen Webtest.
Klicken Sie mit der rechten Maustaste auf eine Anforderung, und wählen Sie Validierungsregel hinzufügen aus, um die benutzerdefinierte Validierungsregel einer Webtestanforderung hinzuzufügen.
Das Dialogfeld Validierungsregel hinzufügen wird angezeigt. Die benutzerdefinierte Validierungsregel wird in der Liste Regel auswählen zusammen mit den vordefinierten Validierungsregeln angezeigt. Wählen Sie die benutzerdefinierte Validierungsregel aus, und klicken Sie dann auf OK.
Führen Sie den Webtest aus.
Beispiel
Im folgenden Code wird eine Implementierung einer benutzerdefinierten Validierungsregel dargestellt. Diese Validierungsregel simuliert das Verhalten einer vordefinierten Validierungsregel Erforderliches Tag. Verwenden Sie dieses Beispiel als Ausgangspunkt für eigene benutzerdefinierte Validierungsregeln.
using System;
using System.Diagnostics;
using System.Globalization;
using Microsoft.VisualStudio.TestTools.WebTesting;
namespace SampleWebTestRules
{
//-------------------------------------------------------------------------
// This class creates a custom validation rule named "Custom Validate Tag"
// The custom validation rule is used to check that an HTML tag with a
// particular name is found one or more times in the HTML response.
// The user of the rule can specify the HTML tag to look for, and the
// number of times that it must appear in the response.
//-------------------------------------------------------------------------
public class CustomValidateTag : ValidationRule
{
/// Specify a name for use in the user interface.
/// The user sees this name in the Add Validation dialog box.
//---------------------------------------------------------------------
public override string RuleName
{
get { return "Custom Validate Tag"; }
}
/// Specify a description for use in the user interface.
/// The user sees this description in the Add Validation dialog box.
//---------------------------------------------------------------------
public override string RuleDescription
{
get { return "Validates that the specified tag exists on the page."; }
}
// The name of the required tag
private string RequiredTagNameValue;
public string RequiredTagName
{
get { return RequiredTagNameValue; }
set { RequiredTagNameValue = value; }
}
// The minimum number of times the tag must appear in the response
private int MinOccurrencesValue;
public int MinOccurrences
{
get { return MinOccurrencesValue; }
set { MinOccurrencesValue = value; }
}
// Validate is called with the test case Context and the request context.
// These allow the rule to examine both the request and the response.
//---------------------------------------------------------------------
public override void Validate(object sender, ValidationEventArgs e)
{
bool validated = false;
int numTagsFound = 0;
foreach (HtmlTag tag in e.Response.HtmlDocument.GetFilteredHtmlTags(RequiredTagName))
{
Debug.Assert(string.Equals(tag.Name, RequiredTagName, StringComparison.InvariantCultureIgnoreCase));
if (++numTagsFound >= MinOccurrences)
{
validated = true;
break;
}
}
e.IsValid = validated;
// If the validation fails, set the error text that the user sees
if (!validated)
{
if (numTagsFound > 0)
{
e.Message = String.Format("Only found {0} occurences of the tag", numTagsFound);
}
else
{
e.Message = String.Format("Did not find any occurences of tag '{0}'", RequiredTagName);
}
}
}
}
}
Imports System
Imports System.Diagnostics
Imports System.Globalization
Imports Microsoft.VisualStudio.TestTools.WebTesting
Namespace SampleWebTestRules
'-------------------------------------------------------------------------
' This class creates a custom validation rule named "Custom Validate Tag"
' The custom validation rule is used to check that an HTML tag with a
' particular name is found one or more times in the HTML response.
' The user of the rule can specify the HTML tag to look for, and the
' number of times that it must appear in the response.
'-------------------------------------------------------------------------
Public Class CustomValidateTag
Inherits Microsoft.VisualStudio.TestTools.WebTesting.ValidationRule
' Specify a name for use in the user interface.
' The user sees this name in the Add Validation dialog box.
'---------------------------------------------------------------------
Public Overrides ReadOnly Property RuleName() As String
Get
Return "Custom Validate Tag"
End Get
End Property
' Specify a description for use in the user interface.
' The user sees this description in the Add Validation dialog box.
'---------------------------------------------------------------------
Public Overrides ReadOnly Property RuleDescription() As String
Get
Return "Validates that the specified tag exists on the page."
End Get
End Property
' The name of the required tag
Private RequiredTagNameValue As String
Public Property RequiredTagName() As String
Get
Return RequiredTagNameValue
End Get
Set(ByVal value As String)
RequiredTagNameValue = value
End Set
End Property
' The minimum number of times the tag must appear in the response
Private MinOccurrencesValue As Integer
Public Property MinOccurrences() As Integer
Get
Return MinOccurrencesValue
End Get
Set(ByVal value As Integer)
MinOccurrencesValue = value
End Set
End Property
' Validate is called with the test case Context and the request context.
' These allow the rule to examine both the request and the response.
'---------------------------------------------------------------------
Public Overrides Sub Validate(ByVal sender As Object, ByVal e As ValidationEventArgs)
Dim validated As Boolean = False
Dim numTagsFound As Integer = 0
For Each tag As HtmlTag In e.Response.HtmlDocument.GetFilteredHtmlTags(RequiredTagName)
Debug.Assert(String.Equals(tag.Name, RequiredTagName, StringComparison.InvariantCultureIgnoreCase))
numTagsFound += 1
If numTagsFound >= MinOccurrences Then
validated = True
Exit For
End If
Next
e.IsValid = validated
' If the validation fails, set the error text that the user sees
If Not (validated) Then
If numTagsFound > 0 Then
e.Message = String.Format("Only found {0} occurences of the tag", numTagsFound)
Else
e.Message = String.Format("Did not find any occurences of tag '{0}'", RequiredTagName)
End If
End If
End Sub
End Class
End Namespace
Siehe auch
Aufgaben
Gewusst wie: Hinzufügen einer Validierungsregel zu einem Webtest
Exemplarische Vorgehensweise: Hinzufügen von Validierungs- und Extraktionsregeln zu einem Webtest
Gewusst wie: Erstellen einer benutzerdefinierten Extraktionsregel
Referenz
Microsoft.VisualStudio.TestTools.WebTesting.Rules