WebControl.Enabled (Propiedad)
Ensamblado: System.Web (en system.web.dll)
[BindableAttribute(true)] [ThemeableAttribute(false)] public virtual bool Enabled { get; set; }
/** @property */ public boolean get_Enabled () /** @property */ public void set_Enabled (boolean value)
public function get Enabled () : boolean public function set Enabled (value : boolean)
Valor de propiedad
Es true si el control está habilitado; en caso contrario, es false. El valor predeterminado es true.Use la propiedad Enabled para especificar o determinar si un control es funcional. Si se establece en false, el control aparece atenuado, lo que impide efectuar ninguna entrada en él.
 Nota: |
|---|
| No todos los exploradores admiten esta propiedad. La función de atenuación y bloqueo del control sólo funciona en exploradores compatibles con Microsoft Internet Explorer versión 4 y posteriores. |
Esta propiedad se propaga hacia abajo en la jerarquía de controles. Por consiguiente, si se deshabilita un control contenedor, se deshabilitarán también todos los controles secundarios contenidos en él.
| Nota: |
|---|
| En un control compuesto personalizado, este comportamiento no se aplica a los controles que todavía no han creado sus controles secundarios. Debe establecer el estado habilitado de los controles secundarios cuando se crean, o reemplazar la propiedad Enabled para llamar al método EnsureChildControls. |
| Nota: |
|---|
| Un control deshabilitado puede admitir devoluciones de datos. Un usuario que ve la página con un control deshabilitado, puede dirigir una solicitud que envía una devolución de datos procesada por la página. Antes de procesar una solicitud de devolución de datos, compruebe que el control está habilitado y visible. |
No todos los controles admiten esta propiedad. Para obtener información, vea los controles individuales.
Esta propiedad no se puede establecer por temas o por temas de hoja de estilos. Para obtener más información, vea ThemeableAttribute y Información general sobre temas y máscaras de ASP.NET.
En el ejemplo siguiente se muestra cómo habilitar y deshabilitar un control TextBox, heredado de la clase base WebControl, estableciendo mediante programación su propiedad Enabled.
| Nota: |
|---|
| El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede que no funcione correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este código de ejemplo en un archivo de texto vacío con una extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas Web ASP.NET. |
 Nota: de seguridad |
|---|
| Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos. |
<%@ 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>
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.