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

true je-li ovládací prvek povolen; falsev opačném případě . 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 a nemusí správně fungovat, pokud se zkopíruje přímo do souboru s kódem. 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 Web Forms naleznete v tématu ASP.NET Web Forms Model kódu stránky.

Důležité

V tomto příkladu je 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 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 Když je vlastnost ovládacího prvku nastavena na false, ovládací prvek se obvykle zobrazuje šedě. Pokud je ovládací prvek vstupní, prohlížeč zabrání uživateli v tom, aby na něj klikl nebo zadal. Elementy HTML, které se vykreslují pro ovládací prvek serveru, jsou označené jako zakázané nastavením atributu disabled nebo atributu CSS class . Další informace naleznete v tématech SupportsDisabledAttribute a ControlRenderingCompatibilityVersion.

Tato vlastnost rozšíří hierarchii ovládacího prvku. Pokud zakážete ovládací prvek kontejneru, podřízené ovládací prvky v rámci daného kontejneru jsou také zakázány. Další informace najdete v IsEnabled této 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. Při vytváření je nutné buď nastavit povolený stav podřízených ovládacích prvků, nebo přepsat Enabled vlastnost pro volání EnsureChildControls metody.

Poznámka

Zakázáním ovládacího prvku zabráníte interakci pouze s ovládacím prvku 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 postback, 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ématech ThemeableAttribute a skinech a ASP.NET.

Platí pro

Viz také