WebControl.Enabled Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Overridable Property Enabled As BooleanValore della proprietà
true se il controllo è abilitato; in caso contrario, false. Il valore predefinito è true.
- Attributi
Esempio
Nell'esempio WebControl seguente viene illustrato come abilitare e disabilitare un TextBox controllo, ereditato dalla classe base, impostando la relativa Enabled 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 Forms, vedere Web Forms ASP.NET Page Code Model.
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 dimmed. Se il controllo è un elemento di input, il browser impedisce all'utente di fare clic o digitarlo. Gli elementi HTML sottoposti a rendering per un controllo server vengono contrassegnati come disabilitati impostando l'attributo disabled o l'attributo CSS class . Per altre informazioni, vedere SupportsDisabledAttribute e ControlRenderingCompatibilityVersion.
Questa proprietà propaga la gerarchia di controllo. Se si disabilita un controllo contenitore, anche i controlli figlio all'interno di tale contenitore sono disabilitati. 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 o eseguire l'override della Enabled proprietà per chiamare il EnsureChildControls metodo.
Nota
La disabilitazione di un controllo impedisce solo l'interazione con il controllo dall'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 skin.