Compartir a través de


WebControl.Enabled Propiedad

Definición

Obtiene o establece un valor que indica si el control de servidor web está habilitado.

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

Valor de propiedad

Es true si el control está habilitado; en caso contrario, es false. De manera predeterminada, es true.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo habilitar y deshabilitar un TextBox control, heredado de la WebControl clase base, estableciendo su Enabled propiedad mediante programación.

Nota

En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de formularios Web Forms, vea ASP.NET modelo de código de página de formularios web Forms.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

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

Comentarios

Cuando la Enabled propiedad de un control se establece falseen , el control normalmente aparece atenuado. Si el control es un elemento de entrada, el explorador impide que el usuario haga clic o escriba en él. Los elementos HTML que se representan para un control de servidor se marcan como deshabilitados estableciendo su disabled atributo o su atributo CSS class . Para obtener más información, vea SupportsDisabledAttribute y ControlRenderingCompatibilityVersion.

Esta propiedad propaga hacia abajo la jerarquía de controles. Si deshabilita un control de contenedor, los controles secundarios de ese contenedor también están deshabilitados. Para obtener más información, vea la propiedad IsEnabled.

Nota

En un control compuesto personalizado, este comportamiento de herencia no se aplica a los controles que aún no han creado sus controles secundarios. Debe establecer el estado habilitado de los controles secundarios cuando se crean o invalidar la Enabled propiedad para llamar al EnsureChildControls método .

Nota

Deshabilitar un control solo impide la interacción con el control por parte del usuario a través de la interfaz de usuario del explorador. Es posible que un usuario cree una solicitud que envíe un postback procesado por la página incluso si los controles de la página están deshabilitados. Antes de procesar una solicitud de postback, compruebe que el control está habilitado y visible.

No todos los controles admiten esta propiedad. Consulte los controles individuales para obtener más información.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también