Actualización: noviembre 2007
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)
Visual Basic (Declaración)
<ThemeableAttribute(True)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class WebControl _
Inherits Control _
Implements IAttributeAccessor
Dim instance As WebControl
[ThemeableAttribute(true)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class WebControl : Control, IAttributeAccessor
[ThemeableAttribute(true)]
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class WebControl : public Control,
IAttributeAccessor
/** @attribute ThemeableAttribute(true) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class WebControl extends Control implements IAttributeAccessor
public class WebControl extends Control implements IAttributeAccessor
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.
Imports System
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace ControlTest
' Renders the following HTML:
' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
Public Class MyWebControl
Inherits WebControl
Public Sub New()
MyBase.New(HtmlTextWriterTag.Span)
End Sub 'New
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
MyBase.AddAttributesToRender(writer)
End Sub 'AddAttributesToRender
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
writer.Write("Custom Contents")
MyBase.RenderContents(writer)
End Sub 'RenderContents
End Class 'MyWebControl
End Namespace 'ControlTest
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
System.Web.UI..::.ScriptControl
System.Web.UI.WebControls..::.BaseDataBoundControl
System.Web.UI.WebControls..::.BaseDataList
System.Web.UI.WebControls..::.Button
System.Web.UI.WebControls..::.Calendar
System.Web.UI.WebControls..::.CheckBox
System.Web.UI.WebControls..::.CompositeControl
System.Web.UI.WebControls..::.DataListItem
System.Web.UI.WebControls..::.FileUpload
System.Web.UI.WebControls..::.HyperLink
System.Web.UI.WebControls..::.Image
System.Web.UI.WebControls..::.Label
System.Web.UI.WebControls..::.LinkButton
System.Web.UI.WebControls..::.LoginName
System.Web.UI.WebControls..::.Panel
System.Web.UI.WebControls..::.SiteMapNodeItem
System.Web.UI.WebControls..::.Table
System.Web.UI.WebControls..::.TableCell
System.Web.UI.WebControls..::.TableRow
System.Web.UI.WebControls..::.TextBox
System.Web.UI.WebControls..::.ValidationSummary
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
.NET Framework
Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Referencia
Otros recursos