BaseValidator.IsValid Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 property bool IsValid { bool get(); void set(bool value); };

[System.ComponentModel.Browsable(false)]
public bool IsValid { get; set; }

[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
public bool IsValid { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.IsValid : bool with get, set

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.Themeable(false)>]
member this.IsValid : bool with get, set

Public Property IsValid As Boolean

Eigenschaftswert

Boolean

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

Implementiert

IsValid

Attribute: BrowsableAttribute ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IsValid -Eigenschaft verwendet wird, um zu bestimmen, ob das zugeordnete Eingabesteuerelement die Überprüfung besteht.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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 (NumberCompareValidator.IsValid && TextBoxRequiredValidator.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 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 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 IsValid -Eigenschaft, um zu bestimmen, ob das zugeordnete Eingabesteuerelement die Überprüfung bestanden hat.

Achtung

Da der Standardwert dieser Eigenschaft ist true, wird sie zurückgegeben true , wenn Sie diese Eigenschaft abfragen, bevor die Überprüfung durchgeführt wird. Dies kann beispielsweise auftreten, wenn Sie versuchen, diese Eigenschaft im Control.Load Fall einer Seite zu verwenden.

Die IsValid -Eigenschaft wird nur ausgewertet, wenn die Validate -Methode aufgerufen wird. Sie können die Validate -Methode für jedes Validierungssteuerelement auf der Seite einzeln aufrufen oder alle auf einmal aufrufen, indem Sie die Page.Validate -Methode verwenden. Schaltflächensteuerelemente, deren CausesValidation Eigenschaft auf festgelegt ist, true rufen auch die Page.Validate -Methode auf.

Hinweis

Es ist möglich, den Wert dieser Eigenschaft nach der Überprüfung manuell zu ändern. Dadurch können Sie das Validierungsergebnis bei Bedarf überschreiben.

Die Page.IsValid Eigenschaft für die Seite ist nur dann auf true festgelegt, wenn die IsValid Eigenschaft für jedes Validierungssteuerelement auf der Seite ebenfalls auf truefestgelegt ist.

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: