WebControl.Enabled WebControl.Enabled WebControl.Enabled WebControl.Enabled Property

Definizione

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.Gets or sets a value indicating whether the Web server control is enabled.

public:
 virtual property bool Enabled { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual bool Enabled { get; set; }
member this.Enabled : bool with get, set
Public Overridable Property Enabled As Boolean

Valore della proprietà

true se il controllo è abilitato; in caso contrario, false.true if control is enabled; otherwise, false. Il valore predefinito è true.The default is true.

Esempi

Nell'esempio seguente viene illustrato come abilitare e disabilitare un TextBox controllo, ereditato WebControl dalla classe base, impostando la relativa Enabled proprietà a livello di codice.The following example illustrates how to enable and disable a TextBox control, inherited from the WebControl base class, by setting its Enabled property programmatically.

Nota

Nell'esempio di codice seguente viene utilizzato il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione aspx.This code sample must be copied into an empty text file that has an .aspx extension. Per ulteriori informazioni sul modello di codice Web Form, vedere il modello di codice della pagina Web form ASP.NET.For more information on the Web Forms code model, see ASP.NET Web Forms 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.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see Script Exploits Overview.

<%@ 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.When the Enabled property of a control is set to false, the control typically appears dimmed. Se il controllo è un elemento di input, il browser impedisce all'utente di fare clic o digitarlo.If the control is an input element, the browser prevents the user from clicking or typing in it. Gli elementi HTML di cui viene eseguito il rendering per un controllo server vengono contrassegnati come disabled disabilitati impostando class il relativo attributo o l'attributo CSS.HTML elements that are rendered for a server control are marked as disabled by setting their disabled attribute or their CSS class attribute. Per altre informazioni, vedere SupportsDisabledAttribute e ControlRenderingCompatibilityVersion.For more information, see SupportsDisabledAttribute and ControlRenderingCompatibilityVersion.

Questa proprietà propaga la gerarchia dei controlli.This property propagates down the control hierarchy. Se si disabilita un controllo contenitore, anche i controlli figlio all'interno di tale contenitore sono disabilitati.If you disable a container control, the child controls within that container are also disabled. Per altre informazioni, vedere la proprietà IsEnabled.For more information, see the IsEnabled property.

Nota

In un controllo composito personalizzato, questo comportamento di ereditarietà non si applica ai controlli che non hanno ancora creato i controlli figlio.In a custom composite control, this inheritance behavior does not apply to controls that have not yet created their child controls. È necessario impostare lo stato abilitato dei controlli figlio al momento della creazione oppure eseguire l'override della Enabled proprietà per chiamare il EnsureChildControls metodo.You must either set the enabled state of the child controls when they are created, or override the Enabled property to call the EnsureChildControls method.

Nota

La disabilitazione di un controllo impedisce solo l'interazione con il controllo da parte dell'utente tramite l'interfaccia utente del browser.Disabling a control only prevents interaction with the control by the user through the browser UI. Un utente può creare una richiesta che invii un postback elaborato dalla pagina anche se i controlli nella pagina sono disabilitati.It is possible for a user to craft a request that submits a postback that is processed by the page even if controls on the page are disabled. Prima di elaborare una richiesta di postback, verificare che il controllo sia abilitato e visibile.Before you process a postback request, check to make sure that the control is enabled and visible.

Questa proprietà non è supportata da tutti i controlli.Not all controls support this property. Per informazioni dettagliate, vedere i singoli controlli.See the individual controls for details.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere ThemeableAttribute e ASP.NET temi e interfacce.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche