BaseValidator.IsValid-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob das zugeordnete Eingabesteuerelement die Validierung erfolgreich absolviert, oder legt diesen fest.

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

Syntax

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

value = instance.IsValid

instance.IsValid = value

[ThemeableAttribute(false)] 
public bool IsValid { get; set; }

[ThemeableAttribute(false)] 
public:
virtual property bool IsValid {
    bool get () sealed;
    void set (bool value) sealed;
}

/** @property */
public final boolean get_IsValid ()

/** @property */
public final void set_IsValid (boolean value)

public final function get IsValid () : boolean

public final function set IsValid (value : boolean)

Eigenschaftenwert

true, wenn das zugeordnete Eingabesteuerelement die Validierung erfolgreich besteht, andernfalls false. Der Standardwert ist true.

Hinweise

Mithilfe der IsValid-Eigenschaft wird bestimmt, ob das zugeordnete Eingabesteuerelement die Validierung erfolgreich besteht.

Warnung

Da true der Standardwert dieser Eigenschaft ist, wird true zurückgegeben, wenn Sie diese Eigenschaft vor dem Ausführen der Validierung abfragen. Dies kann z. B. der Fall sein, wenn Sie diese Eigenschaft im Control.Load-Ereignis einer Seite verwenden möchten.

Die IsValid-Eigenschaft wird nur ausgewertet, wenn die Validate-Methode aufgerufen wird. Sie können die Validate-Methode für jedes auf der Seite angezeigte Validierungssteuerelement einzeln aufrufen, oder Sie rufen mithilfe der Page.Validate-Methode alle Validierungssteuerelemente gleichzeitig auf. Schaltflächen-Steuerelemente, deren CausesValidation-Eigenschaft auf true festgelegt ist, rufen ebenfalls die Page.Validate-Methode auf.

Hinweis

Der Wert dieser Eigenschaft kann manuell geändert werden, nachdem die Validierung beendet wurde. Das heißt, dass Sie ggf. das Ergebnis der Validierung überschreiben können.

Die Page.IsValid-Eigenschaft für die Seite wird nur dann auf true festgelegt, wenn auch die IsValid-Eigenschaft für jedes Validierungssteuerelement auf true festgelegt ist.

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.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der IsValid-Eigenschaft bestimmen, ob das zugeordnete Eingabesteuerelement die Validierung erfolgreich absolviert.

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

<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If NumberCompareValidator.IsValid And TextBoxRequiredValidator.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 (NumberCompareValidator.IsValid && TextBoxRequiredValidator.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
BaseValidator.ControlToValidate-Eigenschaft
Control.Load
Validate
Page.Validate
BaseValidator.IsValid-Eigenschaft
Page.IsValid

Freigeben über