Control Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Define las propiedades, los métodos y los eventos que comparten todos los controles de servidor ASP.NET.

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IParserAccessor

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IControlBuilderAccessor, System::Web::UI::IControlDesignerAccessor, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IExpressionsAccessor, System::Web::UI::IParserAccessor, System::Web::UI::IUrlResolutionService

public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IParserAccessor

[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IControlBuilderAccessor, System.Web.UI.IControlDesignerAccessor, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IExpressionsAccessor, System.Web.UI.IParserAccessor, System.Web.UI.IUrlResolutionService

type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IDataBindingsAccessor

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IUrlResolutionService
    interface IDataBindingsAccessor
    interface IControlBuilderAccessor
    interface IControlDesignerAccessor
    interface IExpressionsAccessor

Public Class Control
Implements IComponent, IDataBindingsAccessor, IDisposable, IParserAccessor

Public Class Control
Implements IComponent, IControlBuilderAccessor, IControlDesignerAccessor, IDataBindingsAccessor, IDisposable, IExpressionsAccessor, IParserAccessor, IUrlResolutionService

Herencia: Object
Control

Derivado: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Más…

Atributos: BindableAttribute ThemeableAttribute

Implementaciones: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Ejemplos

En el ejemplo siguiente se muestra un control de servidor personalizado que se deriva de la Control clase . La InnerContent clase invalida el Control.Render método , comprueba si la clase tiene controles secundarios en la página y determina si el primer elemento secundario del control es un control literal. Si se cumplen ambas condiciones, el método invalidado escribe la cadena <HTML H2>Your Message:, el contenido del control literal y una etiqueta /H2> de cierre <en la página 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.

using System;
using System.Web;
using System.Web.UI;

namespace SimpleControlSamples {

    public class InnerContent : Control {
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }
}

Option Explicit
Option Strict

Imports System.Web
Imports System.Web.UI

Namespace SimpleControlSamples
    Public Class InnerContent
        Inherits Control
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
        Protected Overrides Sub Render(output As HtmlTextWriter)
            
            If HasControls() And TypeOf Controls(0) Is LiteralControl Then
                output.Write("<H2>Your message : ")
                Controls(0).RenderControl(output)
                output.Write("</H2>")
            End If
        End Sub
    End Class
End Namespace 'SimpleControlSamples

Comentarios

Esta es la clase principal de la que deriva al desarrollar controles de servidor de ASP.NET personalizados. Control no tiene ninguna característica específica de la interfaz de usuario (UI). Si va a crear un control que no tiene una interfaz de usuario o combina otros controles que representan su propia interfaz de usuario, derive de Control. Si va a crear un control que tiene una interfaz de usuario, derive de WebControl o cualquier control del System.Web.UI.WebControls espacio de nombres que proporcione un punto de partida adecuado para el control personalizado.

La Control clase es la clase base para todos los controles de servidor de ASP.NET, incluidos controles personalizados, controles de usuario y páginas. ASP.NET páginas son instancias de la Page clase , que hereda de la Control clase y que controlan las solicitudes de archivos que tienen una extensión .aspx.

La Control clase se puede usar directa o indirectamente como parte de la interfaz de usuario de la aplicación web y, como tal, debe examinarse para asegurarse de que se siguen los procedimientos recomendados para escribir código seguro y proteger las aplicaciones.

Para obtener información general sobre estos temas, consulte Introducción a las amenazas de seguridad de aplicaciones web, procedimientos recomendados de directivas de seguridad y conceptos clave de seguridad. Para obtener información más específica, vea Protección de controles estándar, Cómo: Mostrar mensajes de error seguros, Protección contra vulnerabilidades de script en una aplicación web aplicando codificación HTML a cadenas e Introducción a los controles de validación.

Constructores

Control()

Inicializa una nueva instancia de la clase Control.

Propiedades

Adapter	Obtiene el adaptador específico del explorador para el control.
AppRelativeTemplateSourceDirectory	Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.
BindingContainer	Obtiene el control que contiene el enlace de datos de este control.
ChildControlsCreated	Obtiene un valor que indica si se han creado controles secundarios del control de servidor.
ClientID	Obtiene el id. de control para marcado HTML que se genera por ASP.NET.
ClientIDMode	Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.
Context	Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.
Controls	Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.
DesignMode	Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.
EnableTheming	Obtiene o establece un valor que indica si los temas se aplican a este control.
EnableViewState	Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.
Events	Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura.
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.
ID	Obtiene o establece el identificador de programación asignado al control de servidor.
IdSeparator	Obtiene el carácter utilizado para separar los identificadores de control.
IsChildControlStateCleared	Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.
IsTrackingViewState	Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.
IsViewStateEnabled	Obtiene un valor que indica si el estado de vista está habilitado para este control.
LoadViewStateByID	Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.
NamingContainer	Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID.
Page	Obtiene una referencia a la instancia Page que contiene el control de servidor.
Parent	Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.
RenderingCompatibility	Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.
Site	Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.
SkinID	Obtiene o establece la máscara que se aplica al control.
TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control.
TemplateSourceDirectory	Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.
UniqueID	Obtiene el identificador único calificado jerárquicamente para el control de servidor.
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.
ViewState	Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.
ViewStateIgnoresCase	Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.
ViewStateMode	Obtiene o establece el modo del estado de vista de este control.
Visible	Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.

Métodos

AddedControl(Control, Int32)	Se llama después de agregar un control secundario a la colección Controls del objeto Control.
AddParsedSubObject(Object)	Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.
ApplyStyleSheetSkin(Page)	Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.
BeginRenderTracing(TextWriter, Object)	Comienza el seguimiento en tiempo de diseño de los datos de representación.
BuildProfileTree(String, Boolean)	Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.
ClearCachedClientID()	Establece en `null` el valor de ClientID almacenado en caché.
ClearChildControlState()	Elimina la información sobre el estado de control de los controles secundarios del control de servidor.
ClearChildState()	Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.
ClearChildViewState()	Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.
ClearEffectiveClientIDMode()	Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.
CreateChildControls()	Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.
CreateControlCollection()	Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.
DataBind()	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.
DataBind(Boolean)	Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.
DataBindChildren()	Enlaza un origen de datos a los controles secundarios del control de servidor.
Dispose()	Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.
EndRenderTracing(TextWriter, Object)	Finaliza el seguimiento en tiempo de diseño de los datos de representación.
EnsureChildControls()	Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea.
EnsureID()	Crea un identificador para controles que no tiene un identificador asignado.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FindControl(String)	Busca un control de servidor con el parámetro `id` especificado en el contenedor de nomenclatura actual.
FindControl(String, Int32)	Busca el contenedor de nomenclatura actual para un control de servidor con el `id` especificado y un entero, que se especifica en el parámetro `pathOffset`, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.
Focus()	Establece el foco de entrada en un control.
GetDesignModeState()	Obtiene datos en tiempo de diseño para un control.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetRouteUrl(Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.
GetRouteUrl(RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.
GetRouteUrl(String, Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.
GetRouteUrl(String, RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetUniqueIDRelativeTo(Control)	Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.
HasControls()	Determina si el control de servidor contiene controles secundarios.
HasEvents()	Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.
IsLiteralContent()	Determina si el control de servidor alberga únicamente contenido literal.
LoadControlState(Object)	Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().
LoadViewState(Object)	Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState().
MapPathSecure(String)	Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnBubbleEvent(Object, EventArgs)	Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.
OnDataBinding(EventArgs)	Genera el evento DataBinding.
OnInit(EventArgs)	Genera el evento Init.
OnLoad(EventArgs)	Genera el evento Load.
OnPreRender(EventArgs)	Genera el evento PreRender.
OnUnload(EventArgs)	Genera el evento Unload.
OpenFile(String)	Obtiene un objeto Stream utilizado para leer un archivo.
RaiseBubbleEvent(Object, EventArgs)	Asigna los orígenes del evento y su información al control principal del control.
RemovedControl(Control)	Se llama después de quitar un control secundario de la colección Controls del objeto Control.
Render(HtmlTextWriter)	Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente.
RenderChildren(HtmlTextWriter)	Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.
RenderControl(HtmlTextWriter)	Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.
RenderControl(HtmlTextWriter, ControlAdapter)	Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.
ResolveAdapter()	Obtiene el adaptador de controles que se encarga de representar el control especificado.
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede utilizar.
ResolveUrl(String)	Convierte una dirección URL en una que el cliente solicitante pueda utilizar.
SaveControlState()	Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.
SaveViewState()	Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.
SetDesignModeState(IDictionary)	Establece los datos en tiempo de diseño para un control.
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.
SetTraceData(Object, Object)	Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.
SetTraceData(Object, Object, Object)	Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor. Este objeto es accesible a través de la propiedad ViewState.

Eventos

DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos.
Disposed	Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.
Init	Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.
Load	Se produce cuando el control de servidor se carga en el objeto Page.
PreRender	Se produce una vez que se carga el objeto Control, pero antes de su representación.
Unload	Se produce cuando el control de servidor se descarga de la memoria.

Implementaciones de interfaz explícitas

IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, vea ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Para obtener una descripción de este miembro, vea GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Para obtener una descripción de este miembro, vea SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, vea UserData.
IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, vea DataBindings.
IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, vea HasDataBindings.
IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, vea Expressions.
IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, vea HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).

Métodos de extensión

FindDataSourceControl(Control)	Devuelve el origen de datos que está asociado al control de datos del control especificado.
FindFieldTemplate(Control, String)	Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)	Devuelve el objeto de metatabla para el control de datos contenedor.

Se aplica a

Control Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Eventos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Consulte también

Comentarios

Recursos adicionales