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 označující, zda je povolen ovládací prvek webového serveru.
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
truepokud je řízení povoleno; v opačném případě . false Výchozí formát 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 s jedním souborem kódu a nemusí správně fungovat, pokud je zkopírován přímo do souboru s kódem na pozadí. Tento vzorový kód musí být zkopírován do prázdného textového souboru s příponou .aspx. Další informace o modelu kódu webových formulářů najdete v tématu ASP.NET model kódu stránky webových formulářů.
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ěřte, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete 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 nastavená na false, ovládací prvek se obvykle zobrazuje šedě. Pokud je ovládací prvek vstupní prvek, prohlížeč zabrání uživateli v tom, aby na něj klikl nebo zadal. Elementy HTML, které se vykreslují pro serverový ovládací prvek, jsou označeny jako zakázané nastavením jejich disabled atributu nebo atributu CSS class . Další informace naleznete v tématech SupportsDisabledAttribute a ControlRenderingCompatibilityVersion.
Tato vlastnost se šíří v hierarchii ovládacích prvků. Pokud zakážete ovládací prvek kontejneru, jsou zakázány také podřízené ovládací prvky v rámci daného kontejneru. Další informace najdete ve IsEnabled vlastnosti .
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 stav povolení podřízených ovládacích prvků při jejich vytváření, nebo přepsat Enabled vlastnost pro volání EnsureChildControls metody.
Poznámka
Zakázání ovládacího prvku zabrání pouze interakci s ovládacím prvku uživatelem prostřednictvím uživatelského rozhraní prohlížeče. Je možné, aby uživatel vytvořil požadavek, který odešle zpětné odeslání, které je zpracováno stránkou, i když jsou ovládací prvky na stránce zakázány. Před zpracování žádosti o zpětné odeslání zkontrolujte, jestli je ovládací prvek povolený a viditelný.
Ne všechny ovládací prvky tuto vlastnost podporují. Podrobnosti najdete v jednotlivých ovládacích prvcích.
Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.
