Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

BaseValidator.IsValid-Eigenschaft

 

Veröffentlicht: Oktober 2016

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

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

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

Eigenschaftswert

Type: System.Boolean

true Wenn das zugeordnete Eingabesteuerelement die Validierung erfolgreich war; andernfalls false. Der Standardwert ist true.

Implementiert

IValidator.IsValid

Verwenden der IsValid -Eigenschaft bestimmt, ob das zugeordnete Eingabesteuerelement die Validierung erfolgreich war.

System_CAPS_cautionAchtung

Da der Standardwert dieser Eigenschaft ist true, wird zurückgegeben, die true wenn Sie diese Eigenschaft vor dem Ausführen der Validierung Abfragen. Dies kann beispielsweise auftreten, wenn Sie versuchen, diese Eigenschaft in der Control.Load Ereignis einer Seite.

Die IsValid -Eigenschaft wird ausgewertet, nur, wenn die Validate Methode wird aufgerufen. Rufen Sie die Validate Methode für jede Überprüfung-Steuerelement auf der Seite einzeln oder alle auf einmal aufrufen, indem die Page.Validate Methode. Button-Steuerelemente mit ihren CausesValidation Eigenschaft festgelegt, um true auch die Page.Validate Methode.

System_CAPS_noteHinweis

Es ist möglich, den Wert dieser Eigenschaft manuell ändern, nachdem die Validierung ausgeführt wurde. Dadurch können Sie das Ergebnis der Validierung überschreiben bei Bedarf.

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

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

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die IsValid -Eigenschaft bestimmt, ob das zugeordnete Eingabesteuerelement die Validierung erfolgreich war.

System_CAPS_security Sicherheit Hinweis

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 Script Exploits Overview.

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

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: