Exportar (0) Imprimir
Expandir todo

WebControl (Clase)

Actúa como la clase base que define las propiedades, métodos y eventos comunes a todos los controles del espacio de nombres System.Web.UI.WebControls.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

[ThemeableAttribute(true)] 
public class WebControl : Control, IAttributeAccessor
/** @attribute ThemeableAttribute(true) */ 
public class WebControl extends Control implements IAttributeAccessor
ThemeableAttribute(true) 
public class WebControl extends Control implements IAttributeAccessor
No aplicable.

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.

NotaNota:

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.

NotaNota:

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

System.Object
   System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
       Clases derivadas

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar:
© 2014 Microsoft