WebControl (Clase)
Ensamblado: System.Web (en system.web.dll)
La clase WebControl proporciona las propiedades, métodos y eventos que comparten todos los controles de servidor Web. Para controlar la apariencia y el comportamiento de un control de servidor Web, establezca las propiedades definidas en esta clase. Por ejemplo, el color de fondo y el color de fuente de un control se controlan mediante las propiedades BackColor y ForeColor, respectivamente. En los controles que pueden mostrar bordes, se puede controlar el ancho, el estilo y el color del mismo estableciendo las propiedades BorderWidth, BorderStyle y BorderColor. El tamaño de un control de servidor Web se puede especificar mediante las propiedades Height y Width.
El comportamiento del control se puede especificar estableciendo ciertas propiedades. Se puede habilitar y deshabilitar un control estableciendo la propiedad Enabled. La ubicación del control en el orden de tabulación se controla estableciendo la propiedad TabIndex. Se puede especificar la información sobre herramientas para el control, mediante la propiedad ToolTip.
 Nota: |
|---|
| No todos los controles admiten todas las propiedades definidas en esta clase. Para obtener información específica acerca de si se admite o no una propiedad, vea la documentación del control específico. |
| Nota: |
|---|
| Algunas de las propiedades de esta clase se representan de forma distinta en función del explorador. Algunas ni siquiera se representan y otras, aunque lo hagan, no tienen efecto. La propiedad TagWriter del objeto HttpBrowserCapabilities determina de qué forma se representa un control de servidor Web. Para los exploradores compatibles con HTML 4.0, la propiedad TagWriter contiene un objeto HttpBrowserCapabilities normal y la mayoría de las propiedades se representan mediante los atributos de estilo de HTML 4.0. Los exploradores que no se sabe si admiten HTML 4.0 utilizarán el objeto Html32TextWriter. De esta forma, los atributos de estilo se asignan automáticamente a los atributos pertinentes que utilicen etiquetas de HTML 3.2. En algunos casos, como por ejemplo en la propiedad ForeColor, los atributos de estilo se convertirán en etiquetas adicionales, como por ejemplo <font>. En ciertos casos no se efectuará ninguna asignación. Para obtener información específica sobre cómo se representa una propiedad en distintos exploradores, consulte la documentación de la propiedad específica. |
Para obtener una lista con los valores de propiedad iniciales de una instancia de WebControl, vea el constructor WebControl.
namespace ControlTest { using System; using System.Web.UI; using System.Web.UI.WebControls; // Renders the following HTML: // <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span> public class MyWebControl: WebControl { public MyWebControl() : base(HtmlTextWriterTag.Span) { } [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] protected override void AddAttributesToRender(HtmlTextWriter writer) { writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');"); writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red"); base.AddAttributesToRender(writer); } [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] protected override void RenderContents(HtmlTextWriter writer) { writer.Write("Custom Contents"); base.RenderContents(writer); } } }
package ControlTest;
import System.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;
// Renders the following HTML:
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl extends WebControl
{
public MyWebControl()
{
super(HtmlTextWriterTag.Span);
} //MyWebControl
protected void AddAttributesToRender(HtmlTextWriter writer)
{
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
super.AddAttributesToRender(writer);
} //AddAttributesToRender
/** @attribute System.Security.Permissions.PermissionSet(System.Security.
Permissions.SecurityAction.Demand, Name = "FullTrust")
*/
protected void RenderContents(HtmlTextWriter writer)
{
writer.Write("Custom Contents");
super.RenderContents(writer);
} //RenderContents
} //MyWebControl
- AspNetHostingPermission para trabajar en un entorno alojado en host. Valor de la petición: LinkDemand; valor del permiso: Minimal.
- AspNetHostingPermission para trabajar en un entorno alojado en host. Valor de la petición: InheritanceDemand; valor del permiso: Minimal.
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.Referencia
WebControl (Miembros)System.Web.UI.WebControls (Espacio de nombres)
BackColor
ForeColor
BorderWidth
BorderStyle
BorderColor
Height
Width
Enabled
TabIndex
ToolTip
Otros recursos
Controles de servidor Web ASP.NET y funciones del exploradorDesarrollar controles de servidor ASP.NET personalizados
Sintaxis de los controles de servidor Web
Temas y máscaras de ASP.NET
