Поделиться через

WebControl.Enabled Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

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

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.

Атрибуты
BindableAttribute ThemeableAttribute

Примеры

В следующем примере показано, как включить и отключить 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 или атрибут CSS class . Дополнительные сведения см. в разделах SupportsDisabledAttribute и ControlRenderingCompatibilityVersion.

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

Замечание

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

Замечание

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

Не все элементы управления поддерживают это свойство. Дополнительные сведения см. в отдельных элементах управления.

Это свойство не может быть задано темами или темами таблицы стилей. Дополнительные сведения см. в статье ThemeableAttributeи ASP.NET темы и скины.

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

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