IValidator IValidator IValidator IValidator Interface

Определение

Определяет свойства и методы, которые должны быть реализованы объектами, участвующими в проверке веб-форм.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
Производный

Примеры

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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>

Комментарии

Классы, реализующие этот интерфейс, представляют возможную ошибку пользовательского ввода.Classes that implement this interface represent a possible user input error. При вызове IsValidметодакласс обновляет его свойство, чтобы показать, произошла ли ошибка. ValidateWhen the Validate method is called, the class updates its IsValid property to signify whether the error occurred. ErrorMessage Свойство содержит текстовое описание условия ошибки, которое можно отобразить при возникновении ошибки.The ErrorMessage property contains a text description of the error condition that you can display when the error occurs.

Класс реализует этот интерфейс, и все остальные классы проверочных серверных элементов управления ASP.NET наследуются от BaseValidator. BaseValidatorThe BaseValidator class implements this interface, and all other ASP.NET validation server control classes inherit from BaseValidator. Дополнительные сведения об элементах управления сервера проверки и их работе см. в разделе элементы управления проверкой ASP.NET.For information on validation server controls and how they work, see ASP.NET Validation Controls.

Дополнительные сведения о разработке пользовательских серверных элементов управления проверки ASP.NET см. в разделе как Проверьте с помощью пользовательской функции для серверных элементовуправления ASP.NET.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.

Свойства

ErrorMessage ErrorMessage ErrorMessage ErrorMessage

При реализации каким-либо классом получает или задает текст сообщения об ошибке, выдаваемый при сбое проверяемого условия.When implemented by a class, gets or sets the error message text generated when the condition being validated fails.

IsValid IsValid IsValid IsValid

При реализации каким-либо классом получает или задает значение, которое указывает, прошло ли проверку введенное пользователем содержимое указанного элемента управления.When implemented by a class, gets or sets a value indicating whether the user-entered content in the specified control passes validation.

Методы

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

При реализации каким-либо классом оценивает проверяемое условие и обновляет свойство IsValid.When implemented by a class, evaluates the condition it checks and updates the IsValid property.

Применяется к

Дополнительно