WebControl.Enabled Vlastnost

Definice

Získá nebo nastaví hodnotu označující, jestli je povolený ovládací prvek webového serveru.Gets or sets a value indicating whether the Web server control is 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, set
Public Overridable Property Enabled As Boolean

Hodnota vlastnosti

Boolean

truePokud je ovládací prvek povolený; v opačném případě false .true if control is enabled; otherwise, false. Výchozí formát je true.The default is 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ě.The following example illustrates how to enable and disable a TextBox control, inherited from the WebControl base class, by setting its Enabled property programmatically.

Poznámka

Následující ukázka kódu používá model kódu v jednom souboru a nemusí fungovat správně, pokud je zkopírován přímo do souboru kódu na pozadí.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Tato ukázka kódu musí být zkopírována do prázdného textového souboru s příponou. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Další informace o modelu webového formuláře naleznete v tématu ASP.NET Web Forms Code Model.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Důležité

V tomto příkladu je textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba.This example has a text box that accepts user input, which is a potential security threat. Ve výchozím nastavení webové stránky ASP.NET ověřují, zda vstup uživatele nezahrnuje skripty ani prvky jazyka HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Další informace najdete v tématu Přehled zneužití skriptů.For more information, see Script Exploits Overview.

<%@ 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

Když Enabled je vlastnost ovládacího prvku nastavena na false , ovládací prvek je obvykle zobrazen šedě.When the Enabled property of a control is set to false, the control typically appears dimmed. Pokud je ovládací prvek vstupní, prohlížeč znemožní uživateli v něm kliknout nebo zadat jeho zadání.If the control is an input element, the browser prevents the user from clicking or typing in it. Prvky jazyka HTML vykreslené pro serverový ovládací prvek jsou označeny jako zakázané nastavením jejich disabled atributu nebo jeho class atributu CSS.HTML elements that are rendered for a server control are marked as disabled by setting their disabled attribute or their CSS class attribute. Další informace naleznete v tématech SupportsDisabledAttribute a ControlRenderingCompatibilityVersion.For more information, see SupportsDisabledAttribute and ControlRenderingCompatibilityVersion.

Tato vlastnost šíří hierarchii ovládacího prvku dolů.This property propagates down the control hierarchy. Zakážete-li ovládací prvek kontejneru, jsou také zakázány podřízené ovládací prvky v tomto kontejneru.If you disable a container control, the child controls within that container are also disabled. Další informace najdete v tématu IsEnabled vlastnost.For more information, see the IsEnabled property.

Poznámka

V vlastním složeném ovládacím prvku se toto chování dědičnosti nevztahuje na ovládací prvky, které ještě nevytvořily své podřízené ovládací prvky.In a custom composite control, this inheritance behavior does not apply to controls that have not yet created their child controls. Je nutné buď nastavit povolený stav podřízených ovládacích prvků při jejich vytvoření, nebo přepsat Enabled vlastnost pro volání EnsureChildControls metody.You must either set the enabled state of the child controls when they are created, or override the Enabled property to call the EnsureChildControls method.

Poznámka

Zakázání ovládacího prvku zabrání v interakci s ovládacím prvkem prostřednictvím uživatelského rozhraní prohlížeče.Disabling a control only prevents interaction with the control by the user through the browser UI. Uživatel může vytvořit požadavek, který odešle postback, který je zpracován stránkou i v případě, že jsou ovládací prvky na stránce zakázány.It is possible for a user to craft a request that submits a postback that is processed by the page even if controls on the page are disabled. Před zpracováním žádosti o postback ověřte, zda je ovládací prvek povolen a viditelný.Before you process a postback request, check to make sure that the control is enabled and visible.

Ne všechny ovládací prvky tuto vlastnost podporují.Not all controls support this property. Podrobnosti najdete v jednotlivých ovládacích prvcích.See the individual controls for details.

Tuto vlastnost nelze nastavit pomocí motivů nebo motivů šablon stylů.This property cannot be set by themes or style sheet themes. Další informace najdete v tématech ThemeableAttribute a ASP.NET motivy a vzhledy.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Platí pro

Viz také