IValidator IValidator IValidator IValidator Interface

Definition

Definiert die Eigenschaften und Methoden, die von Objekten implementiert werden müssen, die der Web Forms-Validierung unterzogen werden.Defines the properties and methods that objects that participate in Web Forms validation must implement.

public interface class IValidator
public interface IValidator
type IValidator = interface
Public Interface IValidator
Abgeleitet

Beispiele

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>IValidator Example demonstrating IsValid & ErrorMessage</title>
<script language="C#" runat="server">

     void Button_Click(Object sender, EventArgs e)
     {
        // Generating the random number.
        Random rand_s = new Random();
        myCompareValidate.ValueToCompare = rand_s.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>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <head>
    <title>IValidator Example demonstrating IsValid & ErrorMessage</title>
<script language="VB" runat="server">

         Sub Button_Click(sender As [Object], e As EventArgs)
            ' Generating a random number.
            Dim rand_s As New Random()
            myCompareValidate.ValueToCompare = rand_s.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>

Hinweise

Klassen, die diese Schnittstelle implementieren, stellen einen möglichen Benutzereingabe Fehler dar.Classes that implement this interface represent a possible user input error. Wenn die Validate -Methode aufgerufen wird, IsValid aktualisiert die-Klasse die-Eigenschaft, um anzugeben, ob der Fehler aufgetreten ist.When the Validate method is called, the class updates its IsValid property to signify whether the error occurred. Die ErrorMessage -Eigenschaft enthält eine Textbeschreibung der Fehlerbedingung, die angezeigt werden kann, wenn der Fehler auftritt.The ErrorMessage property contains a text description of the error condition that you can display when the error occurs.

Die BaseValidator -Klasse implementiert diese Schnittstelle, und alle anderen ASP.net-Validierungsserver- BaseValidatorSteuerelement Klassen erben von.The BaseValidator class implements this interface, and all other ASP.NET validation server control classes inherit from BaseValidator. Informationen zu Validierungsserver Steuerelementen und ihrer Funktionsweise finden Sie unter ASP.net Validation Controls.For information on validation server controls and how they work, see ASP.NET Validation Controls.

Ausführliche Informationen zum Entwickeln von benutzerdefinierten ASP.net-Validierungsserver Steuerelementen finden Sie unter Gewusst wie: Überprüfen Sie mit einer benutzerdefinierten Funktion fürASP.NET-Server Steuerelemente.For details on how to develop custom ASP.NET validation server controls, see How to: Validate with a Custom Function for ASP.NET Server Controls.

Eigenschaften

ErrorMessage ErrorMessage ErrorMessage ErrorMessage

Ruft bei der Implementierung durch eine Klasse den Text für die Fehlermeldung ab, die generiert wird, wenn die betreffende Bedingung nicht erfüllt ist, oder legt diesen fest.When implemented by a class, gets or sets the error message text generated when the condition being validated fails.

IsValid IsValid IsValid IsValid

Ruft bei der Implementierung durch eine Klasse einen Wert ab, der angibt, ob die Benutzereingaben im angegebenen Steuerelement erfolgreich validiert werden, oder legt diesen fest.When implemented by a class, gets or sets a value indicating whether the user-entered content in the specified control passes validation.

Methoden

Validate() Validate() Validate() Validate()

Wertet bei der Implementierung durch eine Klasse die geprüfte Bedingung aus und aktualisiert die IsValid-Eigenschaft.When implemented by a class, evaluates the condition it checks and updates the IsValid property.

Gilt für:

Siehe auch