PageAdapter Classe

Definição

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

Herança

Object

ControlAdapter

PageAdapter

Exemplos

O exemplo de código seguinte demonstra como derivar uma classe nomeada CustomPageAdapter a partir da PageAdapter classe e sobrepor o RenderBeginHyperlink método. O RenderBeginHyperlink método adiciona um atributo nomeado src a um hiperlink, que contém uma referência para a página atual. Todos os hiperlinks renderizados nas páginas às quais CustomPageAdapter está anexada terão o 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

Observações

A PageAdapter classe é uma classe abstrata que adapta uma página Web para uma classe específica de navegadores, definida pela linguagem de marcação que o navegador utiliza (por exemplo, HTML ou XHTML). Grande parte da adaptabilidade no comportamento de renderização pode ser encapsulada nas classes especializadas de escritores de texto que derivam da HtmlTextWriter classe, pelo que nem sempre é necessário fornecer um adaptador de página.

A maioria dos membros dos adaptadores de página derivados é chamada da Page classe ou de adaptadores de controlo. Primeiro, os Page adaptadores de classe ou controlo detetam a presença do adaptador de página derivado e depois chamam o membro, ou fornecem a funcionalidade se o adaptador de página não estiver presente.

Os membros da PageAdapter classe fornecem a seguinte funcionalidade:

• As CacheVaryByHeaders propriedades e CacheVaryByParams definem cabeçalhos HTTP adicionais e GET HTTP e POST parâmetros que podem ser usados para variar a cache. São chamados durante a inicialização da cache a partir da Page classe.

• O GetStatePersister método devolve um objeto que pode ser usado para persistir os estados combinados de vista e controlo da página. É referenciado pela PageStatePersister propriedade se estiver presente um adaptador de página derivado.

• O GetPostBackFormReference método fornece um fragmento de código DHTML que pode ser usado para referenciar formulários em scripts.

• O DeterminePostBackMode método devolve uma coleção das variáveis de postback se a página estiver em postback. É chamada pelo .NET Framework em vez do método Page.DeterminePostBackMode se houver um adaptador de página derivado.

• Os RenderBeginHyperlink métodos and RenderEndHyperlink são usados por adaptadores de controlo para renderizar hiperligações caso exista um adaptador de página derivado.

• O RenderPostBackEvent método gera um hyperlink ou uma etiqueta de cliente postback que pode submeter o formulário.

• Os RegisterRadioButton métodos and GetRadioButtonsByGroup são usados por adaptadores de controlo de botões de rádio para referenciar os outros RadioButton controlos num grupo de botões de rádio.

• A ClientState propriedade proporciona acesso aos estados combinados de controlo e vista do Page objeto através da propriedade interna ClientState da Page classe.

• O TransformText método é utilizado por adaptadores de controlo para realizar transformações de texto específicas de cada dispositivo.

Ver também

• ControlAdapter