WebControl.Enabled Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállít egy értéket, amely jelzi, hogy a webkiszolgáló-vezérlő engedélyezve van-e.

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

Tulajdonság értéke

Boolean

trueha a vezérlés engedélyezve van; egyéb esetben. false Az alapértelmezett érték a true.

Attribútumok
BindableAttribute ThemeableAttribute

Példák

Az alábbi példa bemutatja, hogyan engedélyezheti és tilthatja le az TextBox alaposztálytól örökölt vezérlőket a WebControl tulajdonság programozott beállításával Enabled .

Note

Az alábbi kódminta az egyfájlos kódmodellt használja, és előfordulhat, hogy nem működik megfelelően, ha közvetlenül egy kód mögötti fájlba másolja. Ezt a kódmintát egy üres szövegfájlba kell másolni, amely .aspx kiterjesztéssel rendelkezik. A Webes űrlapok kódmodellről további információt a ASP.NET Web Forms Lapkódmodell című témakörben talál.

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

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

Megjegyzések

Ha egy Enabled vezérlő tulajdonsága be van állítva false, a vezérlő általában halványan jelenik meg. Ha a vezérlő bemeneti elem, a böngésző megakadályozza, hogy a felhasználó rákattintson vagy begépelje azt. A kiszolgálóvezérlőhöz renderelt HTML-elemek az attribútumuk vagy a CSS-attribútumuk disabledclass beállításával le vannak tiltva. További információ: SupportsDisabledAttribute és ControlRenderingCompatibilityVersion.

Ez a tulajdonság propagálja a vezérlőhierarchiát. Ha letilt egy tárolóvezérlőt, az abban a tárolóban lévő gyermekvezérlők is le lesznek tiltva. További információért lásd a IsEnabled tulajdonságot.

Note

Egyéni összetett vezérlőelemekben ez az öröklési viselkedés nem vonatkozik azokra a vezérlőkre, amelyek még nem hozták létre a gyermekvezérlőket. A gyermekvezérlők engedélyezett állapotát a létrehozásukkor be kell állítania, vagy felül kell bírálnia a Enabled tulajdonságot a EnsureChildControls metódus meghívásához.

Note

A vezérlők letiltása csak a böngésző felhasználói felületén keresztül akadályozza meg a felhasználó által a vezérlővel való interakciót. A felhasználó létrehozhat egy kérelmet, amely postbacket küld, amelyet az oldal feldolgoz, még akkor is, ha az oldalon lévő vezérlők le vannak tiltva. A visszavételi kérés feldolgozása előtt ellenőrizze, hogy a vezérlő engedélyezve van-e és látható-e.

Nem minden vezérlő támogatja ezt a tulajdonságot. Részletekért tekintse meg az egyes vezérlőket.

Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.

A következőre érvényes:

Lásd még