IValidator Arabirim

Tanım

Web Forms doğrulamaya katılan nesnelerin uygulaması gereken özellikleri ve yöntemleri tanımlar.

public interface class IValidator
public interface IValidator
type IValidator = interface
Public Interface IValidator
Türetilmiş

Örnekler

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.

<!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>

Açıklamalar

Bu arabirimi uygulayan sınıflar olası bir kullanıcı giriş hatalarını temsil eden sınıflar. Validate yöntemi çağrıldığında, sınıfı hatanın oluşup oluşmadığını göstermek için özelliğini güncelleştirirIsValid. özelliği, ErrorMessage hata oluştuğunda görüntüleyebileceğiniz hata koşulunun metin açıklamasını içerir.

BaseValidator sınıfı bu arabirimi uygular ve diğer tüm ASP.NET doğrulama sunucusu denetim sınıfları öğesinden BaseValidatordevralır. Doğrulama sunucusu denetimleri ve bunların nasıl çalıştığı hakkında bilgi için bkz . Doğrulama Denetimleri ASP.NET.

Özel ASP.NET doğrulama sunucusu denetimleri geliştirme hakkında ayrıntılı bilgi için bkz . Nasıl yapılır: ASP.NET Sunucu Denetimleri için Özel İşlevle Doğrulama.

Özellikler

ErrorMessage

Bir sınıf tarafından uygulandığında, doğrulanan koşul başarısız olduğunda oluşturulan hata iletisi metnini alır veya ayarlar.

IsValid

Bir sınıf tarafından uygulandığında, belirtilen denetimde kullanıcı tarafından girilen içeriğin doğrulamayı geçip geçmeyeceğini belirten bir değer alır veya ayarlar.

Yöntemler

Validate()

Bir sınıf tarafından uygulandığında, denetlediği koşulu değerlendirir ve özelliği güncelleştirir IsValid .

Şunlara uygulanır

Ayrıca bkz.