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 seguente viene illustrato come abilitare e disabilitare un TextBox controllo, ereditato dalla WebControl classe di base, impostandone la Enabled proprietà a livello di codice.
Annotazioni
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
In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di 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 l'attributo disabled o il relativo attributo CSS class . Per altre informazioni, vedere SupportsDisabledAttribute e ControlRenderingCompatibilityVersion.
Questa proprietà propaga verso il basso la gerarchia dei controlli. Se si disabilita un controllo contenitore, anche i controlli figlio all'interno di tale contenitore vengono disabilitati. Per ulteriori informazioni, consultare la proprietà IsEnabled.
Annotazioni
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 della Enabled proprietà per chiamare il EnsureChildControls metodo .
Annotazioni
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 in base a temi o temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.
