Sdílet prostřednictvím

WebControl.Enabled Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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, set
Public Overridable Property Enabled As Boolean

Hodnota vlastnosti

Boolean

truepokud je řízení povoleno; v opačném případě . false Výchozí formát je true.

Atributy
BindableAttribute ThemeableAttribute

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.

Platí pro

Viz také