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