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, setPublic Overridable Property Enabled As 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 атрибут или атрибут CSS class . Дополнительные сведения см. в разделах SupportsDisabledAttribute и ControlRenderingCompatibilityVersion.
Это свойство распространяется вниз по иерархии элементов управления. Если отключить элемент управления контейнером, дочерние элементы управления в этом контейнере также будут отключены. Дополнительные сведения см. в описании свойства IsEnabled.
Примечание
В пользовательском составном элементе управления такое поведение наследования не применяется к элементам управления, которые еще не создали свои дочерние элементы управления. Необходимо либо задать состояние включения дочерних элементов управления при их создании, либо переопределить Enabled свойство для вызова EnsureChildControls метода .
Примечание
Отключение элемента управления предотвращает только взаимодействие пользователя с элементом управления через пользовательский интерфейс браузера. Пользователь может создать запрос, который отправляет обратную передачу, которая обрабатывается страницей, даже если элементы управления на странице отключены. Перед обработкой запроса обратной передачи убедитесь, что элемент управления включен и виден.
Не все элементы управления поддерживают это свойство. Дополнительные сведения см. в разделе об отдельных элементах управления.
Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.
