BaseValidator.Enabled BaseValidator.Enabled BaseValidator.Enabled BaseValidator.Enabled Property

Определение

Получает или задает значение, показывающее, включен ли элемент управления проверки.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

Значение свойства

Значение true, если элемент управления проверки включен; в противном случае — значение false.true if the validation control is enabled; otherwise, false. Значение по умолчанию — true.The default is true.

Примеры

В следующем примере кода показано, как использовать Enabled свойство для включения или отключения элементов управления проверки на веб-странице с помощью кода на стороне сервера.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.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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>

В следующем примере кода показано, как использовать Enabled свойство для включения или отключения элементов управления проверки на веб-странице с помощью кода на стороне клиента.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.

Комментарии

Enabled Используйте свойство, чтобы указать, включен ли элемент управления проверки.Use the Enabled property to specify whether the validation control is enabled. Вы можете отключить проверочный элемент управления, задав для falseэтого свойства значение.You can disable the validation control by setting this property to false.

Если задать Enabled для Control.Visible свойстваfalse или значение, будет запрещено выполнение проверки.Setting either the Control.Visible or the Enabled property to false will prevent validation from being performed. Это приводит к IsValid тому, что свойство всегда trueбудет иметь значение.This causes the IsValid property to always evaluate to true.

Свойство немного отличается Control.Visible от свойства. EnabledThe Enabled property is slightly different from the Control.Visible property. Если свойство элемента управления проверки имеет trueзначение, но Enabled свойство имеет значение false, элемент управления проверки по-прежнему отображается для проверки на стороне клиента, но находится в отключенном состоянии. Control.VisibleIf 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. Затем можно повторно включить проверочный элемент управления на клиенте с помощью скрипта DHTML.You can then re-enable the validation control on the client by using DHTML script.

Применяется к