BaseValidator.ControlToValidate-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Property ControlToValidate As String
'Usage
Dim instance As BaseValidator
Dim value As String

value = instance.ControlToValidate

instance.ControlToValidate = value

[ThemeableAttribute(false)] 
public string ControlToValidate { get; set; }

[ThemeableAttribute(false)] 
public:
property String^ ControlToValidate {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ControlToValidate ()

/** @property */
public void set_ControlToValidate (String value)

public function get ControlToValidate () : String

public function set ControlToValidate (value : String)

Eigenschaftenwert

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

Hinweise

Mithilfe der ControlToValidate-Eigenschaft wird das zu validierende Eingabesteuerelement angegeben. Abgesehen vom CustomValidator-Steuerelement, das leer gelassen werden kann, muss diese Eigenschaft bei allen Validierungssteuerelementen auf die ID eines Eingabesteuerelements festgelegt werden. Wenn Sie kein gültiges Eingabesteuerelement angeben, wird beim Wiedergeben der Seite eine Ausnahme ausgelöst. Die ID muss auf ein Steuerelement in dem Container verweisen, in dem sich auch das Validierungssteuerelement befindet. Sie muss sich auf derselben Seite oder in demselben Benutzersteuerelement befinden, oder sie muss in derselben Vorlage wie ein aus einer Vorlage gebildetes Steuerelement sein.

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

Hinweis

Damit ein Eingabesteuerelement validiert werden kann, muss ihm das System.Web.UI.ValidationPropertyAttribute-Attribut zugeordnet werden.

Mit Ausnahme des RequiredFieldValidator-Steuerelements bestehen alle Validierungssteuerelemente die Validierung erfolgreich, wenn das von der ControlToValidate-Eigenschaft angegebene Eingabesteuerelement keinen Text enthält. Wenn Sie ein CustomValidator-Steuerelement verwenden, werden die clientseitigen und serverseitigen Validierungsfunktionen auch nicht aufgerufen.

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

Thema	Position
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite	Erstellen von Anwendungen mit Visual Web Developer

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der ControlToValidate-Eigenschaft das zu validierende Eingabesteuerelement angeben.

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

<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>
  <body>
    <form 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>

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

<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>
  <body>
    <form 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="JScript" %>

<script runat="server">
 
  function Button_Click(sender, e : EventArgs) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form 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>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

BaseValidator-Klasse
BaseValidator-Member
System.Web.UI.WebControls-Namespace
String.Empty
System.Web.UI.ValidationPropertyAttribute
RequiredFieldValidator
CustomValidator

Freigeben über