Aracılığıyla paylaş

BaseValidator.ControlToValidate Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Doğrulamak için giriş denetimini alır veya ayarlar.

public:
 property System::String ^ ControlToValidate { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))]
public string ControlToValidate { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))]
[System.Web.UI.Themeable(false)]
public string ControlToValidate { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))>]
member this.ControlToValidate : string with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))>]
[<System.Web.UI.Themeable(false)>]
member this.ControlToValidate : string with get, set
Public Property ControlToValidate As String

Özellik Değeri

String

Doğrulanması gereken giriş denetimi. Varsayılan değer, Emptybu özelliğin ayarlanmadığını gösteren değeridir.

Öznitelikler
TypeConverterAttribute ThemeableAttribute

Örnekler

Aşağıdaki kod örneği, özelliğinin ControlToValidate doğrulanması için giriş denetimini belirtmek için nasıl kullanılacağını gösterir.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

<%@ Page Language="VB" AutoEventWireup="False" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Açıklamalar

ControlToValidate Doğrulamak için giriş denetimini belirtmek için özelliğini kullanın. Bu özellik, denetim dışındaki tüm doğrulama denetimleri için bir giriş denetiminin kimliğine CustomValidator ayarlanmalıdır ve bu kimlik boş bırakılabilir. Geçerli bir giriş denetimi belirtmezseniz, sayfa işlendiğinde bir özel durum oluşturulur. Kimlik, doğrulama denetimiyle aynı kapsayıcı içindeki bir denetime başvurmalıdır. Aynı sayfada veya kullanıcı denetiminde veya şablonlu denetimin aynı şablonunda olmalıdır.

Doğrulanabilen standart denetimler şunlardır:

Uyarı

Giriş denetiminin doğrulanması için özniteliğin System.Web.UI.ValidationPropertyAttribute denetime uygulanması gerekir.

Denetimi dışındaki RequiredFieldValidator tüm doğrulama denetimleri, özelliği tarafından belirtilen giriş denetimi metin içermiyorsa doğrulamayı ControlToValidate geçirir. Denetim CustomValidator kullanıyorsanız, istemci tarafı ve sunucu tarafı doğrulama işlevleri de çağrılmaz.

Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . Temalar ve Dış Görünümler'i ASP.NET.

Şunlara uygulanır

Ayrıca bkz.