PageAdapter Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.Adapters

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í.

Adapta una página Web para un explorador concreto y proporciona la clase base de la que heredan todos los adaptadores de página, directa o indirectamente.

public ref class PageAdapter abstract : System::Web::UI::Adapters::ControlAdapter

public abstract class PageAdapter : System.Web.UI.Adapters.ControlAdapter

type PageAdapter = class
    inherit ControlAdapter

Public MustInherit Class PageAdapter
Inherits ControlAdapter

Herencia: Object

ControlAdapter
PageAdapter

Ejemplos

En el ejemplo de código siguiente se muestra cómo derivar una clase denominada CustomPageAdapter de la PageAdapter clase e invalidar el RenderBeginHyperlink método . El RenderBeginHyperlink método agrega un atributo denominado src a un hipervínculo, que contiene una referencia a la página actual. Todos los hipervínculos representados en páginas a las que CustomPageAdapter se adjunta tendrá el src atributo .

using System;
using System.IO;
using System.Web;
using System.Web.UI;
using System.Web.UI.Adapters;

// A derived PageAdapter class.
public class CustomPageAdapter : PageAdapter
{
    // Override RenderBeginHyperlink to add an attribute that 
    // references the referring page.
    public override void RenderBeginHyperlink(
        HtmlTextWriter writer, string targetUrl,
        bool encodeUrl, string softkeyLabel, 
        string accessKey )
    {
        string url = null;

        // Add the src attribute, if referring page URL is available.
        if( Page != null && Page.Request != null &&
            Page.Request.Url != null )
        {
            url = Page.Request.Url.AbsoluteUri;
            if( encodeUrl )
                url = HttpUtility.HtmlAttributeEncode( url );
            writer.AddAttribute( "src", url );
        }

        // Add the accessKey attribute, if caller requested.
        if( accessKey != null && accessKey.Length == 1 )
            writer.AddAttribute( "accessKey", accessKey );

        // Add the href attribute, encode the URL if requested.
        if( encodeUrl )
            url = HttpUtility.HtmlAttributeEncode( targetUrl );
        else
            url = targetUrl;
        writer.AddAttribute( "href", url );

        // Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag( "a" );
    }
}

Imports System.IO
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.Adapters

' A derived PageAdapter class.
Public Class CustomPageAdapter
    Inherits PageAdapter

    ' Override RenderBeginHyperlink to add an attribute that 
    ' references the referring page.
    Public Overrides Sub RenderBeginHyperlink( _
        ByVal writer As HtmlTextWriter, ByVal targetUrl As String, _
        ByVal encodeUrl As Boolean, ByVal softkeyLabel As String, _
        ByVal accessKey As String)

        Dim url As String

        ' Add the src attribute, if referring page URL is available.
        If Not (Page Is Nothing) Then
            If Not (Page.Request Is Nothing) Then
                If Not (Page.Request.Url Is Nothing) Then

                    url = Page.Request.Url.AbsoluteUri
                    If encodeUrl Then
                        url = HttpUtility.HtmlAttributeEncode(url)
                    End If
                    writer.AddAttribute("src", url)
                End If
            End If
        End If

        ' Render the accessKey attribute, if requested.
        If Not (accessKey Is Nothing) Then
            If accessKey.Length = 1 Then
                writer.AddAttribute("accessKey", accessKey)
            End If
        End If

        ' Add the href attribute, encode the URL if requested.
        If (encodeUrl) Then
            url = HttpUtility.HtmlAttributeEncode(targetUrl)
        Else
            url = targetUrl
        End If
        writer.AddAttribute("href", url)

        ' Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag("a")

    End Sub
End Class

Comentarios

La PageAdapter clase es una clase abstracta que adapta una página web para una clase específica de exploradores, definida por el lenguaje de marcado que usa el explorador (por ejemplo, HTML o XHTML). Gran parte de la adaptabilidad en el comportamiento de representación se puede encapsular en las clases especializadas del escritor de texto que derivan de la HtmlTextWriter clase, por lo que no siempre es necesario proporcionar un adaptador de página.

La mayoría de los miembros de los adaptadores de página derivados se llaman desde la Page clase o desde adaptadores de control. En primer lugar, los Page adaptadores de clase o control detectan la presencia del adaptador de página derivada y, a continuación, llaman al miembro o proporcionan la funcionalidad si el adaptador de página no está presente.

Los miembros de la PageAdapter clase proporcionan la siguiente funcionalidad:

Las CacheVaryByHeaders propiedades y CacheVaryByParams definen encabezados HTTP adicionales y HTTP GET y POST parámetros que se pueden usar para variar el almacenamiento en caché. Se les llama durante la inicialización de caché desde la Page clase .
El GetStatePersister método devuelve un objeto que se puede usar para conservar los estados de vista y control combinados de la página. Se hace referencia a ella desde la PageStatePersister propiedad si hay un adaptador de página derivado.
El GetPostBackFormReference método proporciona un fragmento de código DHTML que se puede usar para hacer referencia a formularios en scripts.
El DeterminePostBackMode método devuelve una colección de las variables de postback si la página está en postback. Lo llama el .NET Framework en lugar del Page.DeterminePostBackMode método si hay un adaptador de página derivado.
Los adaptadores de control usan los RenderBeginHyperlink métodos y RenderEndHyperlink para representar hipervínculos si existe un adaptador de página derivada.
El RenderPostBackEvent método representa una etiqueta de cliente de hipervínculo o postback que puede enviar el formulario.
Los RegisterRadioButton adaptadores de control de botón de radio usan los métodos y GetRadioButtonsByGroup para hacer referencia a los demás RadioButton controles de un grupo de botones de radio.
La ClientState propiedad proporciona acceso al control combinado y a los estados de vista del Page objeto a través de la propiedad interna ClientState de la Page clase .
Los adaptadores de control usan el TransformText método para realizar la transformación de texto específica del dispositivo.

Constructores

PageAdapter()

Inicializa una nueva instancia de la clase PageAdapter.

Propiedades

Browser	Obtiene una referencia a las posibilidades del explorador del cliente que realiza la solicitud HTTP actual. (Heredado de ControlAdapter)
CacheVaryByHeaders	Obtiene una lista de encabezados HTTP adicionales por los que se varía el almacenamiento en caché en la página Web a la que este adaptador de página derivado está asociado.
CacheVaryByParams	Obtiene una lista de parámetros adicionales de solicitudes GET y POST HTTP mediante los que se varía el almacenamiento en memoria caché de la página Web a la que está asociado este adaptador de página derivado.
ClientState	Obtiene una cadena codificada que contiene los datos de la vista y de los estados de control de la página Web a la que está asociado este adaptador de página derivado.
Control	Obtiene una referencia al control al que está asociado este adaptador de control. (Heredado de ControlAdapter)
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)
DeterminePostBackMode()	Determina si la página web está en postback y devuelve una colección de nombres/valores de las variables de postback.
DeterminePostBackModeUnvalidated()	Devuelve una colección de datos de nombre-valor que se envió a la página con un comando POST o GET, sin realizar la validación de solicitudes de ASP.NET en la solicitud.
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)
GetPostBackFormReference(String)	Devuelve un fragmento de código DHTML que el explorador cliente puede utilizar para hacer referencia al formulario de la página que se envió.
GetRadioButtonsByGroup(String)	Recupera una colección de controles de botón de radio especificada por `groupName`.
GetStatePersister()	Devuelve un objeto utilizado por la página Web para mantener los estados de control y vista.
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)
RegisterRadioButton(RadioButton)	Agrega un control de botón de radio a la colección para un grupo de botones de radio especificado.
Render(HtmlTextWriter)	Genera el marcado específico del destino para el control al que está asociado el adaptador de control. (Heredado de ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Representa una etiqueta de hipervínculo de apertura que incluye la dirección URL de destino para la secuencia de respuesta.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Representa una etiqueta de apertura de hipervínculo que incluye la dirección URL de destino y una clave de acceso a la secuencia de respuesta.
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)
RenderEndHyperlink(HtmlTextWriter)	Representa una etiqueta de cierre de hipervínculo a la secuencia de respuesta.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String)	Representa un evento de postback en la secuencia de respuesta como un hipervínculo, incluidos el estado de vista codificado y posiblemente cifrado, así como el destino del evento y el argumento.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Representa un evento de postback en la secuencia de respuesta como un hipervínculo, incluidos el estado de vista codificado y posiblemente cifrado, así como un destino del evento, un argumento, un parámetro de página anterior y una clave de acceso.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Representa un evento de postback en la secuencia de respuesta como un hipervínculo, incluidos el estado de vista codificado, así como un destino del evento, un argumento, un parámetro de página anterior y una clave de acceso.
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)
TransformText(String)	Transforma el texto para el explorador de destino.

Se aplica a

Consulte también

ControlAdapter