WebControlAdapter Clase
Definición
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í.
Personaliza la representación del control Web al que está asociado el adaptador de control, para modificar el marcado o el comportamiento predeterminado para exploradores concretos.
public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapterpublic class WebControlAdapter : System.Web.UI.Adapters.ControlAdaptertype WebControlAdapter = class
inherit ControlAdapterPublic Class WebControlAdapter
Inherits ControlAdapter- Herencia
- Derivado
Comentarios
La WebControl clase es la clase base de la que heredan los controles Web. Define muchas propiedades comunes a todos los controles web. Para obtener más información, vea WebControl.
Un objeto es un componente que sustituye determinada clase o métodos y eventos heredados en su ciclo de vida de ejecución para permitir el control específico del WebControlAdapter WebControl marcado o del explorador. El .NET Framework asigna un único adaptador de control a un objeto WebControl derivado para cada solicitud de cliente.
Un adaptador modifica un comportamiento de control para un explorador o clase de exploradores específicos o actúa como filtro arbitrario en alguna funcionalidad. Gran parte de la adaptabilidad en el comportamiento de representación se puede encapsular en las clases especializadas que derivan de la HtmlTextWriter clase . Por lo tanto, es probable que se pueda usar un único adaptador para una serie de comportamientos de clase de explorador o que la inclusión de la adaptabilidad en las clases pueda hacer innecesario el uso de un adaptador HtmlTextWriter de control.
Los propios controles no requieren necesariamente un adaptador. Si los controles se extienden a través de la composición, generalmente los adaptadores de los controles secundarios son suficientes.
Cada control tiene asignaciones explícitas a adaptadores a través de los archivos de definición .browser. Por lo tanto, cualquier acceso a la propiedad de utiliza el objeto extraído de los archivos de definición de .browser para realizar la búsqueda de la asignación Adapter del adaptador que se va a WebControl HttpBrowserCapabilities controlar.
Durante el procesamiento, el .NET Framework intercepta las llamadas a los métodos reemplazables de un control que podría ser específico del destino. Si se adjunta un adaptador de control, el .NET Framework llama a los métodos de adaptador asociados. Para obtener más información, vea ControlAdapter.
La representación de un normalmente consta de una etiqueta inicial y final, y un marcado interno entre las WebControl etiquetas inicial y final. Las etiquetas se definen cuando se WebControl crea . Para obtener más información, vea WebControl.
Los métodos y generan las RenderBeginTag RenderEndTag etiquetas, respectivamente. El marcado interno lo genera el RenderContents método .
El Render método genera todo el marcado mediante una llamada a los métodos en el orden siguiente:
La IsEnabled propiedad devuelve solo si y todos sus controles true WebControl primarios están habilitados. La Control propiedad devuelve una referencia fuertemente con tipo a WebControl .
Constructores
| WebControlAdapter() |
Inicializa una nueva instancia de la clase WebControlAdapter. |
Propiedades
| Browser |
Obtiene una referencia a las posibilidades del explorador del cliente que realiza la solicitud HTTP actual. (Heredado de ControlAdapter) |
| Control |
Obtiene una referencia al control Web al que está asociado este adaptador de control. |
| IsEnabled |
Obtiene un valor que indica si están habilitados el control Web y todos sus controles principales. |
| Page |
Obtiene una referencia a la página donde reside el control asociado a este adaptador. (Heredado de ControlAdapter) |
| PageAdapter |
Obtiene una referencia al adaptador de la página donde reside el control asociado. (Heredado de ControlAdapter) |
Métodos
| BeginRender(HtmlTextWriter) |
Se le llama antes de la representación de un control. En una clase de adaptador derivada, genera etiquetas de apertura requeridas por un destino concreto pero que no son necesarias para los exploradores de HTML. (Heredado de ControlAdapter) |
| CreateChildControls() |
Crea los controles secundarios específicos del destino para un control compuesto. (Heredado de ControlAdapter) |
| EndRender(HtmlTextWriter) |
Se le llama después de la representación de un control. En una clase de adaptador derivada, genera etiquetas de cierre requeridas por un destino concreto pero que no son necesarias para los exploradores de HTML. (Heredado de ControlAdapter) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| LoadAdapterControlState(Object) |
Carga información de estado del control de adaptador, guardada por SaveAdapterControlState() durante una solicitud anterior, en la página donde reside el control asociado a este adaptador de control. (Heredado de ControlAdapter) |
| LoadAdapterViewState(Object) |
Carga información del estado de la vista del adaptador, guardada por SaveAdapterViewState() durante una solicitud anterior, en la página donde reside el control asociado a este adaptador de control. (Heredado de ControlAdapter) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnInit(EventArgs) |
Reemplaza el método OnInit(EventArgs) para el control asociado. (Heredado de ControlAdapter) |
| OnLoad(EventArgs) |
Reemplaza el método OnLoad(EventArgs) para el control asociado. (Heredado de ControlAdapter) |
| OnPreRender(EventArgs) |
Reemplaza el método OnPreRender(EventArgs) para el control asociado. (Heredado de ControlAdapter) |
| OnUnload(EventArgs) |
Reemplaza el método OnUnload(EventArgs) para el control asociado. (Heredado de ControlAdapter) |
| Render(HtmlTextWriter) |
Genera el marcado específico del destino para el control al que está asociado el adaptador de control. |
| RenderBeginTag(HtmlTextWriter) |
Crea la etiqueta de principio para el control Web en el marcado transmitido al explorador de destino. |
| RenderChildren(HtmlTextWriter) |
Genera el marcado específico del destino para los controles secundarios en un control compuesto al que está asociado el adaptador de control. (Heredado de ControlAdapter) |
| RenderContents(HtmlTextWriter) |
Genera el marcado interno específico del destino para el control Web al que está asociado el adaptador de control. |
| RenderEndTag(HtmlTextWriter) |
Crea la etiqueta de cierre del control Web en el marcado transmitido al explorador de destino. |
| SaveAdapterControlState() |
Guarda información de estado de control para el adaptador de control. (Heredado de ControlAdapter) |
| SaveAdapterViewState() |
Guarda información del estado de vista para el adaptador de control. (Heredado de ControlAdapter) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |