BaseValidator.ControlToValidate Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft das zu überprüfende Eingabesteuerelement ab oder legt dieses fest.

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

Eigenschaftswert

String

Das zu überprüfende Eingabesteuerelement. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Attribute
TypeConverterAttribute ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ControlToValidate -Eigenschaft verwendet wird, um das zu überprüfende Eingabesteuerelement anzugeben.

<%@ 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 die ControlToValidate -Eigenschaft, um das zu überprüfende Eingabesteuerelement anzugeben. Diese Eigenschaft muss auf die ID eines Eingabesteuerelements für alle Validierungssteuerelemente außer dem CustomValidator Steuerelement festgelegt werden, das leer gelassen werden kann. Wenn Sie kein gültiges Eingabesteuerelement angeben, wird beim Rendern der Seite eine Ausnahme ausgelöst. Die ID muss auf ein Steuerelement im selben Container wie das Validierungssteuerelement verweisen. Es muss sich auf demselben Seiten- oder Benutzersteuerelement befinden, oder es muss sich in derselben Vorlage eines Steuerelements mit Vorlagen befinden.

Die Standardsteuerelemente, die überprüft werden können, sind:

Hinweis

Damit ein Eingabesteuerelement überprüft werden kann, muss das System.Web.UI.ValidationPropertyAttribute Attribut auf das Steuerelement angewendet werden.

Alle Validierungssteuerelemente mit Ausnahme des RequiredFieldValidator -Steuerelements bestehen die Überprüfung, wenn das von der ControlToValidate -Eigenschaft angegebene Eingabesteuerelement keinen Text enthält. Wenn Sie ein CustomValidator Steuerelement verwenden, werden auch die clientseitigen und serverseitigen Validierungsfunktionen nicht aufgerufen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen