IValidator-Schnittstelle

Artikel
08/20/2007

Definiert die Eigenschaften und Methoden, die von Objekten implementiert werden müssen, die der Web Forms-Validierung unterzogen werden.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Interface IValidator
'Usage
Dim instance As IValidator

public interface IValidator

public interface class IValidator

public interface IValidator

public interface IValidator

Hinweise

Klassen, die diese Schnittstelle implementieren, stellen einen möglichen Fehler in Benutzereingaben dar. Wenn die Validate-Methode aufgerufen wird, aktualisiert die Klasse ihre IsValid-Eigenschaft, um anzeigen zu können, ob der Fehler aufgetreten ist. Die ErrorMessage-Eigenschaft enthält eine Textbeschreibung der Fehlerbedingung, die beim Auftreten des Fehlers angezeigt werden kann.

Die BaseValidator-Klasse implementiert diese Schnittstelle, und alle anderen ASP.NET-Serversteuerelementklassen für die Validierung werden von BaseValidator vererbt. Informationen zu Serversteuerelementen für die Validierung und ihrer Funktionsweise finden Sie unter ASP.NET-Validierungssteuerelemente.

Einzelheiten über die Entwicklung benutzerdefinierter ASP.NET-Serversteuerelemente für die Validierung finden Sie unter Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente.

Beispiel

<HTML>
   <HEAD>
      <script language="VB" runat="server">

         Sub Button_Click(sender As [Object], e As EventArgs)
            ' Generating a random number.
            Dim rand_number As New Random()
            myCompareValidate.ValueToCompare = rand_number.Next(1, 10).ToString()

            ' Set the ErrorMessage.
            myCompareValidate.ErrorMessage = "Try Again!!"
            myCompareValidate.Validate()

            ' Check for Validity of control.
            If myCompareValidate.IsValid And myTextBox.Text <> "" Then
               labelOutput.Text = "You guessed correctly!!"
               labelOutput.ForeColor = System.Drawing.Color.Blue
            Else
               labelOutput.Text = "You guessed poorly"
               labelOutput.ForeColor = System.Drawing.Color.Black
            End If

            labelOutput.Text += "<br><br>" + "The number is: " + _
               myCompareValidate.ValueToCompare
         End Sub 'Button_Click

  </Script>
</HEAD>
    <body>
       <form runat="server" ID="myForm">
          <h3>IValidator Example demonstrating IsValid & ErrorMessage</h3>
          <h5>Guess!! a number between 1 and 10:</h5>
          <asp:TextBox id="myTextBox" runat="server" />
          <asp:CompareValidator id="myCompareValidate"
               ControlToValidate="myTextBox" ValueToCompare="0"
               EnableClientScript="False" Type="Integer" Text="*"
               runat="server" />
          <br>
          <asp:Button Text="Submit" OnClick="Button_Click" runat="server" />
          <br>
          <asp:Label id="labelOutput" runat="server" />
          <br>
          <asp:ValidationSummary id="Summary1" runat="server" />
       </form>
    </body>
</HTML>

<HTML>
  <HEAD>
    <script language="C#" runat="server">

     void Button_Click(Object sender, EventArgs e)
     {
        // Generating the random number.
        Random rand_number = new Random();
        myCompareValidate.ValueToCompare = rand_number.Next(1, 10).ToString();

        // Setting the ErrorMessage.
        myCompareValidate.ErrorMessage="Try Again!!";
        myCompareValidate.Validate();

        // Check for Validity of control.
        if ((myCompareValidate.IsValid) && (myTextBox.Text != ""))
        {
           labelOutput.Text = "You guessed correctly!!";
           labelOutput.ForeColor = System.Drawing.Color.Blue;
        }
        else
        {
           labelOutput.Text =  "You guessed poorly";
           labelOutput.ForeColor = System.Drawing.Color.Black;
        }

        labelOutput.Text += "<br><br>" + "The number is: " +
           myCompareValidate.ValueToCompare;
     }

  </script>
</HEAD>
    <body>
      <form runat="server" ID="myForm">
        <h3>IValidator Example demonstrating IsValid & ErrorMessage</h3>
        <h5>Guess!! a number between 1 and 10 :</h5>
        <asp:TextBox id="myTextBox" runat="server" />
        <asp:CompareValidator id="myCompareValidate"
             ControlToValidate="myTextBox" ValueToCompare="0"
             EnableClientScript="False" Type="Integer" Text="*"
             runat="server" />
        <br>
        <asp:Button Text="Submit" OnClick="Button_Click" runat="server" />
        <br>
        <asp:Label id="labelOutput" runat="server" />
        <br>
        <asp:ValidationSummary id="Summary1" runat="server" />
     </form>
  </body>
</HTML>

<HTML>
  <HEAD>
    <script language="VJ#" runat="server">

    void Button_Click(Object sender, EventArgs e)
    {
        // Generating the random number.
        Random randNumber = new Random();
        myCompareValidate.set_ValueToCompare(
            System.Convert.ToString(randNumber.Next(1, 10)));

        // Setting the ErrorMessage.
        myCompareValidate.set_ErrorMessage("Try Again!!");
        myCompareValidate.Validate();

        // Check for Validity of control.
        if (myCompareValidate.get_IsValid() 
            && (!(myTextBox.get_Text().Equals("")))) {
            labelOutput.set_Text("You guessed correctly!!");
            labelOutput.set_ForeColor(System.Drawing.Color.get_Blue());
        }
        else {
            labelOutput.set_Text("You guessed poorly");
            labelOutput.set_ForeColor(System.Drawing.Color.get_Black());
        }
        labelOutput.set_Text(labelOutput.get_Text() + "<br><br>" 
            + "The number is: " + myCompareValidate.get_ValueToCompare());
    } //Button_Click

  </script>
</HEAD>
    <body>
      <form runat="server" ID="myForm">
        <h3>IValidator Example demonstrating IsValid & ErrorMessage</h3>
        <h5>Guess!! a number between 1 and 10 :</h5>
        <asp:TextBox id="myTextBox" runat="server" />
        <asp:CompareValidator id="myCompareValidate"
             ControlToValidate="myTextBox" ValueToCompare="0"
             EnableClientScript="False" Type="Integer" Text="*"
             runat="server" />
        <br>
        <asp:Button ID="Button1" Text="Submit" OnClick="Button_Click" runat="server" />
        <br>
        <asp:Label id="labelOutput" runat="server" />
        <br>
        <asp:ValidationSummary id="Summary1" runat="server" />
     </form>
  </body>
</HTML>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

IValidator-Member
System.Web.UI-Namespace
ValidatorCollection
Validators
BaseValidator
BaseCompareValidator
CompareValidator
CustomValidator
RangeValidator
RegularExpressionValidator
RequiredFieldValidator

Weitere Ressourcen

Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente
ASP.NET-Validierungssteuerelemente

Freigeben über