IValidator IValidator IValidator IValidator Interface

定義

Web フォームの検証に参加するオブジェクトが実装する必要があるプロパティとメソッドを定義します。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 Web ページによって、ユーザー入力にスクリプトまたは 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.

クラスBaseValidatorはこのインターフェイスを実装し、他のすべての ASP.NET 検証サーバーコントロールBaseValidatorクラスはを継承します。The BaseValidator class implements this interface, and all other ASP.NET validation server control classes inherit from BaseValidator. 検証サーバーコントロールとその動作の詳細については、「 ASP.NET Validation controls」を参照してください。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.

適用対象

こちらもご覧ください