Control Clase

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Define las propiedades, los métodos y los eventos compartidos por todos los controles de servidor de 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
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 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 de formularios Web Forms.

Importante

Este ejemplo tiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad de script.

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 a la que se 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 espacio de nombres que proporcione un punto de partida adecuado para el System.Web.UI.WebControls control personalizado.

La clase Control 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 clase , que hereda de la clase />

La Control clase puede usarse 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 directiva 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, Cómo: Proteger 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

Nombre Description
Control()

Inicializa una nueva instancia de la clase Control.

Propiedades

Nombre Description
Adapter

Obtiene el adaptador específico del explorador para el control .
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o 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 los controles secundarios del control de servidor.
ClientID

Obtiene el identificador de control para el marcado HTML generado por ASP.NET.
ClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad .
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad .
Context

Obtiene el HttpContext objeto asociado al control de servidor para la solicitud web actual.
Controls

Obtiene un ControlCollection objeto 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 el contenedor de nomenclatura implementa IDataItemContainer.
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl.
DesignMode

Obtiene un valor que indica si se usa 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 y el estado de vista de los controles secundarios que contiene, al cliente solicitante.
Events

Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura.
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada.
ID

Obtiene o establece el identificador de programación asignado al control de servidor.
IdSeparator

Obtiene el carácter usado para separar los identificadores de control.
IsChildControlStateCleared

Obtiene un valor que indica si los controles contenidos en este control tienen estado de control.
IsTrackingViewState

Obtiene un valor que indica si el control de servidor guarda los cambios 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 en ID lugar del índice.
NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar entre los controles de servidor con el mismo ID valor de propiedad.
Page

Obtiene una referencia a la Page instancia que contiene el control de servidor.
Parent

Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página.
RenderingCompatibility

Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML.
Site

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.
SkinID

Obtiene o establece la máscara que se va a aplicar 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 detectar valores potencialmente peligrosos.
ViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página.
ViewStateIgnoresCase

Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas.
ViewStateMode

Obtiene o establece el modo de 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

Nombre Description
AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la Controls colección del Control objeto .
AddParsedSubObject(Object)

Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor.
ApplyStyleSheetSkin(Page)

Aplica las propiedades de estilo definidas en la hoja de estilos de página al control .
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 entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página.
ClearCachedClientID()

Establece el valor ClientIDalmacenado en caché en null .
ClearChildControlState()

Elimina la información de estado de control de los controles secundarios del control de servidor.
ClearChildState()

Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor.
ClearChildViewState()

Elimina la información de estado de vista de todos los controles secundarios del control de servidor.
ClearEffectiveClientIDMode()

Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit.
CreateChildControls()

Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación.
CreateControlCollection()

Crea un nuevo ControlCollection objeto para contener los controles secundarios (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 invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento.
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.
Dispose()

Permite que un control de servidor realice la limpieza final antes de liberarse 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 es así, crea controles secundarios.
EnsureID()

Crea un identificador para los controles que no tienen asignado un identificador.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
FindControl(String, Int32)

Busca en el contenedor de nomenclatura actual un control de servidor con el especificado id y un entero, especificado en el pathOffset parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método.
FindControl(String)

Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado id .
Focus()

Establece el foco de entrada en un control.
GetDesignModeState()

Obtiene los datos en tiempo de diseño de un control.
GetHashCode()

Actúa 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 prefijo de la UniqueID propiedad del control especificado.
HasControls()

Determina si el control de servidor contiene controles secundarios.
HasEvents()

Devuelve un valor que indica si los eventos están registrados para el control o para los controles secundarios.
IsLiteralContent()

Determina si el control de servidor contiene solo contenido literal.
LoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método .
LoadViewState(Object)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el SaveViewState() método .
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 Objectactual.

(Heredado de Object)
OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario 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 que se usa para leer un archivo.
RaiseBubbleEvent(Object, EventArgs)

Asigna cualquier origen del evento y su información al elemento primario del control.
RemovedControl(Control)

Se llama después de quitar un control secundario de la Controls colección del Control objeto .
Render(HtmlTextWriter)

Envía el contenido del control de servidor a un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente.
RenderChildren(HtmlTextWriter)

Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente.
RenderControl(HtmlTextWriter, ControlAdapter)

Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter .
RenderControl(HtmlTextWriter)

Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado.
ResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede usar.
ResolveUrl(String)

Convierte una dirección URL en una que se pueda usar en el cliente solicitante.
SaveControlState()

Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor.
SaveViewState()

Guarda los cambios de estado de vista de control de servidor que se han producido desde el momento en que la página se devolvió al servidor.
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño de un control.
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario.
SetTraceData(Object, Object, Object)

Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento.
SetTraceData(Object, Object)

Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Provoca el seguimiento de los cambios de estado de vista en el control de servidor para que se puedan almacenar en el objeto del control de StateBag servidor. Este objeto es accesible a través de la ViewState propiedad .

Eventos

Nombre Description
DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.
Disposed

Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET.
Init

Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida.
Load

Se produce cuando el control de servidor se carga en el Page objeto .
PreRender

Se produce después de cargar el Control objeto, pero antes de la representación.
Unload

Se produce cuando el control de servidor se descarga de la memoria.

Implementaciones de interfaz explícitas

Nombre Description
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

Nombre Description
FindDataSourceControl(Control)

Devuelve el origen de datos asociado al control de datos para el control especificado.
FindFieldTemplate(Control, String)

Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)

Devuelve el objeto de metatable para el control de datos contenedor.

Se aplica a

Consulte también