WebControl.Enabled Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen.
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 BooleanHodnota vlastnosti
trueje-li povolen ovládací prvek; v opačném případě . false Výchozí hodnota je true.
- Atributy
Příklady
Následující příklad ukazuje, jak povolit a zakázat TextBox ovládací prvek zděděný ze WebControl základní třídy nastavením jeho Enabled vlastnosti programově.
Poznámka:
Následující ukázka kódu používá model kódu s jedním souborem a při kopírování přímo do souboru s kódem nemusí správně fungovat. Tento vzorový kód musí být zkopírován do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webového formuláře najdete v tématu ASP.NET model kódu stránky webového formuláře.
Důležité
Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.
<%@ 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>
Poznámky
Enabled Pokud je vlastnost ovládacího prvku nastavena na false, ovládací prvek se obvykle zobrazuje šedě. Pokud je ovládací prvek vstupním prvkem, prohlížeč zabrání uživateli kliknout nebo zadat ho. Elementy HTML vykreslené pro ovládací prvek serveru jsou označeny jako zakázané nastavením atributu disabled nebo atributu CSS class . Pro více informací se podívejte na SupportsDisabledAttribute a ControlRenderingCompatibilityVersion.
Tato vlastnost rozšíří hierarchii ovládacího prvku. Pokud zakážete ovládací prvek kontejneru, podřízené ovládací prvky v daném kontejneru jsou také zakázány. Další informace najdete ve vlastnosti IsEnabled.
Poznámka:
Ve vlastním složeného ovládacího prvku se toto chování dědičnosti nevztahuje na ovládací prvky, které ještě nevytvořily podřízené ovládací prvky. Musíte buď nastavit povolený stav podřízených ovládacích prvků při jejich vytvoření, nebo přepsat Enabled vlastnost volání EnsureChildControls metody.
Poznámka:
Zakázáním ovládacího prvku zabráníte interakci s ovládacím prvek uživatelem prostřednictvím uživatelského rozhraní prohlížeče. Uživatel může vytvořit žádost, která odešle zpětné odeslání, které je zpracováno stránkou, i když jsou ovládací prvky na stránce zakázané. Než zpracujete požadavek zpětného odeslání, zkontrolujte, jestli je ovládací prvek povolený a viditelný.
Tuto vlastnost nepodporují všechny ovládací prvky. Podrobnosti najdete v jednotlivých ovládacích prvcích.
Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.
