BaseValidator.Enabled Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob das Validierungssteuerelement aktiviert ist, oder legt diesen fest.Gets or sets a value that indicates whether the validation control is enabled.

public:
 virtual property bool Enabled { bool get(); void set(bool value); };
public override bool Enabled { get; set; }
member this.Enabled : bool with get, set
Public Overrides Property Enabled As Boolean

Eigenschaftswert

true, wenn das Validierungssteuerelement aktiviert ist, andernfalls false.true if the validation control is enabled; otherwise, false. Die Standardeinstellung ist true.The default is true.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Enabled -Eigenschaft verwendet wird, um die Validierungs Steuerelemente auf der Webseite mithilfe von Server seitigem Code zu aktivieren oder zu deaktivieren.The following code example demonstrates how to use the Enabled property to enable or disable the validation controls on the Web page using server-side code.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see 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 (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="*"
        enabled="false"
        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="*"
        enabled="false"
        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>

Im folgenden Codebeispiel wird veranschaulicht, wie die Enabled -Eigenschaft verwendet wird, um die Validierungs Steuerelemente auf der Webseite mithilfe des Client seitigen Codes zu aktivieren oder zu deaktivieren.The following code example demonstrates how to use the Enabled property to enable or disable the validation controls on the Web page using client-side code.

Hinweise

Verwenden Sie Enabled die-Eigenschaft, um anzugeben, ob das Validierungs Steuerelement aktiviert ist.Use the Enabled property to specify whether the validation control is enabled. Sie können das Validierungs Steuerelement deaktivieren, indem Sie diese falseEigenschaft auf festlegen.You can disable the validation control by setting this property to false.

Wenn Sie entweder Control.Visible die- Enabled Eigenschaft oder false die-Eigenschaft auf festlegen, wird die Überprüfung nicht ausgeführt.Setting either the Control.Visible or the Enabled property to false will prevent validation from being performed. Dies bewirkt, IsValid dass die-Eigenschaft immer trueals ausgewertet wird.This causes the IsValid property to always evaluate to true.

Die Enabled -Eigenschaft unterscheidet sich gering Control.Visible fügig von der-Eigenschaft.The Enabled property is slightly different from the Control.Visible property. Wenn die Control.Visible -Eigenschaft für ein Validierungs Steuerelement auf truefestgelegt ist Enabled , die-Eigenschaft falsejedoch auf festgelegt ist, wird das Validierungs Steuerelement immer noch für die Client seitige Validierung, aber in einem deaktivierten Zustand gerendert.If the Control.Visible property for a validation control is set to true, but the Enabled property is set to false, the validation control is still rendered for client-side validation, but in a disabled state. Anschließend können Sie das Validierungs Steuerelement auf dem Client mithilfe des DHTML-Skripts erneut aktivieren.You can then re-enable the validation control on the client by using DHTML script.

Gilt für: