BaseValidator.ControlToValidate Eigenschaft

Definition

Ruft das zu überprüfende Eingabesteuerelement ab oder legt dieses fest.Gets or sets the input control to validate.

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

Eigenschaftswert

Das zu überprüfende Eingabesteuerelement.The input control to validate. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default value is Empty, which indicates that this property is not set.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ControlToValidate -Eigenschaft verwendet wird, um das zu validierende Eingabe Steuerelement anzugeben.The following code example demonstrates how to use the ControlToValidate property to specify the input control to validate.

<%@ 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>

Hinweise

Verwenden Sie ControlToValidate die-Eigenschaft zum Angeben des zu validierenden Eingabe Steuer Elements.Use the ControlToValidate property to specify the input control to validate. Diese Eigenschaft muss auf die ID eines Eingabe Steuer Elements für alle Validierungs Steuerelemente mit Ausnahme des CustomValidator -Steuer Elements festgelegt werden, das leer bleiben kann.This property must be set to the ID of an input control for all validation controls except the CustomValidator control, which can be left blank. Wenn Sie kein gültiges Eingabe Steuerelement angeben, wird eine Ausnahme ausgelöst, wenn die Seite gerendert wird.If you do not specify a valid input control, an exception will be thrown when the page is rendered. Die ID muss auf ein Steuerelement innerhalb desselben Containers verweisen wie das Validierungs Steuerelement.The ID must refer to a control within the same container as the validation control. Sie muss sich in derselben Seite oder in einem Benutzer Steuerelement befinden, oder Sie muss sich in derselben Vorlage eines Steuer Elements mit Vorlagen befinden.It must be in the same page or user control, or it must be in the same template of a templated control.

Die Standard Steuerelemente, die überprüft werden können, sind:The standard controls that can be validated are:

Hinweis

Damit ein Eingabe Steuerelement überprüft werden kann, System.Web.UI.ValidationPropertyAttribute muss das-Attribut auf das-Steuerelement angewendet werden.For an input control to be validated, the System.Web.UI.ValidationPropertyAttribute attribute must be applied to the control.

Alle Validierungs Steuerelemente, mit RequiredFieldValidator Ausnahme des-Steuer Elements, übergeben die Validierung, wenn das ControlToValidate von der-Eigenschaft angegebene Eingabe Steuerelement keinen Text enthält.All validation controls, except the RequiredFieldValidator control, will pass validation if the input control specified by the ControlToValidate property contains no text. Wenn Sie ein CustomValidator -Steuerelement verwenden, werden die Client seitigen und serverseitigen Validierungs Funktionen nicht als bezeichnet.If you are using a CustomValidator control, the client-side and server-side validation functions are not called either.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch