Condividi tramite

WebControl.Enabled Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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
BindableAttribute ThemeableAttribute

Esempio

Nell'esempio seguente viene illustrato come abilitare e disabilitare un TextBox controllo, ereditato dalla classe base, impostandone la WebControlEnabled proprietà a livello 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 codice Web Form, vedere ASP.NET modello di codice della pagina Web Form.

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 false, il controllo viene in genere visualizzato in 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 CSS class . Per altre informazioni, vedere SupportsDisabledAttribute e ControlRenderingCompatibilityVersion.

Questa proprietà si propaga 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 al momento della creazione oppure eseguire l'override della Enabled proprietà per chiamare il EnsureChildControls metodo .

Nota

La disabilitazione di un controllo impedisce solo l'interazione con il controllo da parte dell'utente tramite l'interfaccia utente del browser. È possibile che un utente possa creare una richiesta che invii 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 e interfacce.

Si applica a

Vedi anche