WebControl.Enabled Свойство

Определение

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.

public:
 virtual property bool Enabled { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
public virtual bool Enabled { get; set; }
[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual bool Enabled { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Enabled : bool with get, set
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
member this.Enabled : bool with get, set
Public Overridable Property Enabled As Boolean

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

Boolean

true, если элемент управления включен, в противном случае — false. Значение по умолчанию — true.

Атрибуты

Примеры

В следующем примере показано, как включить и отключить TextBox элемент управления, унаследованный от WebControl базового класса, путем установки его Enabled свойства программным способом.

Примечание

В следующем примере кода используется модель кода с одним файлом, и она может работать неправильно, если копировать их непосредственно в файл кода программной части. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

<%@ 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 SubmitBtn1_Click(object sender, EventArgs e)
    {
        TextBox1.Enabled = (!TextBox1.Enabled);
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>Enabled Property Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h3>Enabled Property of a Web Control</h3>
            <p>
                <asp:TextBox id="TextBox1" BackColor="LightBlue" 
                    runat="server">Light Blue</asp:TextBox>
            </p>
            <p>
                <asp:TextBox id="TextBox2" BackColor="LightGreen" 
                    runat="server">Light Green</asp:TextBox>
            </p>
            <asp:Button id="SubmitBtn1" runat="server"
                Text="Click to disable or enable the light blue text box" 
                OnClick="SubmitBtn1_Click" />
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Sub SubmitBtn1_Click(ByVal sender As Object, ByVal e As EventArgs)
        TextBox1.Enabled = Not (TextBox1.Enabled)
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>Enabled Property Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h3>Enabled Property of a Web Control</h3>
            <p>
                <asp:TextBox id="TextBox1" BackColor="LightBlue" 
                    runat="server">Light Blue</asp:TextBox>
            </p>
            <p>
                <asp:TextBox id="TextBox2" BackColor="LightGreen" 
                    runat="server">Light Green</asp:TextBox>
            </p>
            <asp:Button id="SubmitBtn1" runat="server"
                Text="Click to disable or enable the light blue text box" 
                OnClick="SubmitBtn1_Click" />
    </div>
    </form>
</body>
</html>

Комментарии

Если Enabled свойство элемента управления имеет значение false , элемент управления обычно отображается серым цветом. Если элемент управления является элементом ввода, браузер не сможет его щелкнуть или ввести в него. Элементы HTML, отображаемые для серверного элемента управления, помечаются как отключенные путем установки их disabled атрибутов или class атрибутов CSS. Дополнительные сведения см. в разделах SupportsDisabledAttribute и ControlRenderingCompatibilityVersion.

Это свойство распространяется вниз по иерархии элементов управления. Если отключить контейнерный элемент управления, дочерние элементы управления в этом контейнере также будут отключены. Дополнительные сведения см. в описании свойства IsEnabled.

Примечание

В пользовательском составном элементе управления это поведение наследования не применяется к элементам управления, которые еще не создали их дочерние элементы управления. Необходимо либо задать включенное состояние дочерних элементов управления при их создании, либо переопределить Enabled свойство для вызова EnsureChildControls метода.

Примечание

Отключение элемента управления предотвращает взаимодействие с элементом управления пользователем через пользовательский интерфейс браузера. Пользователь может создавать запрос, который отправляет обратную передачу, обрабатываемую страницей, даже если элементы управления на этой странице отключены. Перед обработкой запроса на обратную передачу убедитесь, что элемент управления включен и видим.

Это свойство поддерживается не всеми элементами управления. Подробные сведения см. в отдельных элементах управления.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в статьях ThemeableAttribute и ASP.NET Themes и обложки.

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

См. также раздел