WebControl.Enabled Proprietà

Definizione

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.

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

Valore della proprietà

Boolean

true se il controllo è abilitato; in caso contrario, false. Il valore predefinito è true.

Attributi

Esempio

Nell'esempio seguente viene illustrato come abilitare e disabilitare un controllo ereditato dalla classe TextBox WebControl di base impostandone la proprietà a livello Enabled di codice.

Nota

L'esempio di codice seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione aspx. Per altre informazioni sul modello di Web Forms, vedere ASP.NET Web Forms code model della pagina.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.

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

Commenti

Quando la Enabled proprietà di un controllo è impostata su , il controllo viene in genere visualizzato in false grigio. Se il controllo è un elemento di input, il browser impedisce all'utente di fare clic o digitarlo. Gli elementi HTML di cui viene eseguito il rendering per un controllo server vengono contrassegnati come disabilitati impostando il relativo disabled attributo o il relativo attributo class CSS. Per altre informazioni, vedere SupportsDisabledAttribute e ControlRenderingCompatibilityVersion.

Questa proprietà viene propagata verso il basso nella gerarchia dei controlli. Se si disabilita un controllo contenitore, vengono disabilitati anche i controlli figlio all'interno di tale contenitore. Per altre informazioni, vedere la proprietà IsEnabled.

Nota

In un controllo composito personalizzato questo comportamento di ereditarietà non si applica ai controlli che non hanno ancora creato i controlli figlio. È necessario impostare lo stato abilitato dei controlli figlio quando vengono creati oppure eseguire l'override Enabled della proprietà per chiamare il metodo EnsureChildControls .

Nota

La disabilitazione di un controllo impedisce solo l'interazione con il controllo da parte dell'utente tramite l'interfaccia utente del browser. Un utente può creare una richiesta che invia un postback elaborato dalla pagina anche se i controlli nella pagina sono disabilitati. Prima di elaborare una richiesta di postback, verificare che il controllo sia abilitato e visibile.

Non tutti i controlli supportano questa proprietà. Per informazioni dettagliate, vedere i singoli controlli.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET temi ed interfaccia.

Si applica a

Vedi anche