WebControl.Enabled WebControl.Enabled WebControl.Enabled WebControl.Enabled Property

Определение

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.Gets or sets a value indicating whether the Web server control is enabled.

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

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

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

Примеры

В следующем примере показано, как включить и отключить TextBox элемент управления, унаследованный WebControl от базового класса, путем установки его Enabled свойства программным способом.The following example illustrates how to enable and disable a TextBox control, inherited from the WebControl base class, by setting its Enabled property programmatically.

Примечание

В следующем примере кода используется модель кода с одним файлом, и она может работать неправильно, если копировать их непосредственно в файл кода программной части.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Важно!

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

Комментарии

Если свойство элемента управления имеет falseзначение, элемент управления обычно отображается серым цветом. EnabledWhen the Enabled property of a control is set to false, the control typically appears dimmed. Если элемент управления является элементом ввода, браузер не сможет его щелкнуть или ввести в него.If the control is an input element, the browser prevents the user from clicking or typing in it. Элементы HTML, отображаемые для серверного элемента управления, помечаются как отключенные путем установки disabled их class атрибутов или атрибутов CSS.HTML elements that are rendered for a server control are marked as disabled by setting their disabled attribute or their CSS class attribute. Дополнительные сведения см. в разделах SupportsDisabledAttribute и ControlRenderingCompatibilityVersion.For more information, see SupportsDisabledAttribute and ControlRenderingCompatibilityVersion.

Это свойство распространяется вниз по иерархии элементов управления.This property propagates down the control hierarchy. Если отключить контейнерный элемент управления, дочерние элементы управления в этом контейнере также будут отключены.If you disable a container control, the child controls within that container are also disabled. Дополнительные сведения см. в описании свойства IsEnabled.For more information, see the IsEnabled property.

Примечание

В пользовательском составном элементе управления это поведение наследования не применяется к элементам управления, которые еще не создали их дочерние элементы управления.In a custom composite control, this inheritance behavior does not apply to controls that have not yet created their child controls. Необходимо либо задать включенное состояние дочерних элементов управления при их создании, либо переопределить Enabled свойство для EnsureChildControls вызова метода.You must either set the enabled state of the child controls when they are created, or override the Enabled property to call the EnsureChildControls method.

Примечание

Отключение элемента управления предотвращает взаимодействие с элементом управления пользователем через пользовательский интерфейс браузера.Disabling a control only prevents interaction with the control by the user through the browser UI. Пользователь может создавать запрос, который отправляет обратную передачу, обрабатываемую страницей, даже если элементы управления на этой странице отключены.It is possible for a user to craft a request that submits a postback that is processed by the page even if controls on the page are disabled. Перед обработкой запроса на обратную передачу убедитесь, что элемент управления включен и видим.Before you process a postback request, check to make sure that the control is enabled and visible.

Это свойство поддерживается не всеми элементами управления.Not all controls support this property. Подробные сведения см. в отдельных элементах управления.See the individual controls for details.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

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

Дополнительно