WebControl.Enabled Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om webbserverkontrollen är aktiverad.

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

Egenskapsvärde

Boolean

trueom kontrollen är aktiverad. annars . false Standardvärdet är true.

Attribut
BindableAttribute ThemeableAttribute

Exempel

I följande exempel visas hur du aktiverar och inaktiverar en TextBox kontroll, som ärvs från basklassen WebControl , genom att ange dess Enabled egenskap programmatiskt.

Note

Följande kodexempel använder kodmodellen med en fil och kanske inte fungerar korrekt om den kopieras direkt till en kod bakom-fil. Det här kodexemplet måste kopieras till en tom textfil som har ett .aspx-tillägg. Mer information om kodmodellen Web Forms finns i ASP.NET Web Forms Page Code Model.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

När egenskapen för Enabled en kontroll är inställd på falsevisas kontrollen vanligtvis nedtonad. Om kontrollen är ett indataelement hindrar webbläsaren användaren från att klicka eller skriva in den. HTML-element som återges för en serverkontroll markeras som inaktiverade genom att deras attribut eller CSS-attribut disabled angesclass. Mer information finns i SupportsDisabledAttribute och ControlRenderingCompatibilityVersion.

Den här egenskapen sprids nedåt i kontrollhierarkin. Om du inaktiverar en containerkontroll inaktiveras även de underordnade kontrollerna i containern. För mer information, se egenskapen IsEnabled.

Note

I en anpassad sammansatt kontroll gäller inte det här arvsbeteendet för kontroller som ännu inte har skapat sina underordnade kontroller. Du måste antingen ange det aktiverade tillståndet för de underordnade kontrollerna när de skapas eller åsidosätta Enabled egenskapen för att anropa EnsureChildControls metoden.

Note

Om du inaktiverar en kontroll förhindras endast interaktion med kontrollen av användaren via webbläsarens användargränssnitt. Det är möjligt för en användare att skapa en begäran som skickar ett återskick som bearbetas av sidan även om kontroller på sidan är inaktiverade. Kontrollera att kontrollen är aktiverad och synlig innan du bearbetar en postback-begäran.

Alla kontroller stöder inte den här egenskapen. Mer information finns i de enskilda kontrollerna.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även