PageAdapter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.Adapters

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Adatta una pagina Web per un browser specifico e fornisce la classe base dalla quale ereditano tutti gli adattatori di pagina, direttamente o indirettamente.

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

Ereditarietà: Object

ControlAdapter
PageAdapter

Esempio

Nell'esempio di codice seguente viene illustrato come derivare una classe denominata CustomPageAdapter dalla classe ed eseguire l'override PageAdapter del RenderBeginHyperlink metodo . Il RenderBeginHyperlink metodo aggiunge un attributo denominato src a un collegamento ipertestuale, che contiene un riferimento alla pagina corrente. Tutti i collegamenti ipertestuali visualizzati nelle pagine a cui CustomPageAdapter è collegato avranno l'attributo src .

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

Commenti

La PageAdapter classe è una classe astratta che adatta una pagina Web per una classe specifica di browser, definita dal linguaggio di markup usato dal browser , ad esempio HTML o XHTML. Gran parte dell'adattabilità nel comportamento di rendering può essere incapsulata nelle classi di writer di testo specializzate che derivano dalla HtmlTextWriter classe , quindi non è sempre necessario fornire un adattatore di pagina.

La maggior parte dei membri degli adattatori di pagina derivati viene chiamata dalla Page classe o dagli adattatori di controllo. Prima di tutto, gli Page adattatori di classe o controllo rilevano la presenza dell'adattatore di pagina derivato e quindi chiamano il membro oppure forniscono la funzionalità se l'adattatore di pagina non è presente.

I membri della PageAdapter classe forniscono le funzionalità seguenti:

Le CacheVaryByHeaders proprietà e CacheVaryByParams definiscono intestazioni HTTP aggiuntive e HTTP GET e POST parametri che possono essere usati per variare la memorizzazione nella cache. Vengono chiamati durante l'inizializzazione della Page cache dalla classe .
Il GetStatePersister metodo restituisce un oggetto che può essere utilizzato per rendere persistenti gli stati di visualizzazione e controllo combinati della pagina. Viene fatto riferimento dalla PageStatePersister proprietà se è presente un adattatore di pagina derivato.
Il GetPostBackFormReference metodo fornisce un frammento di codice DHTML che può essere usato per fare riferimento ai moduli negli script.
Il DeterminePostBackMode metodo restituisce una raccolta delle variabili di postback se la pagina è in postback. Viene chiamato dal .NET Framework anziché dal Page.DeterminePostBackMode metodo se è presente un adattatore di pagina derivato.
I RenderBeginHyperlink metodi e RenderEndHyperlink vengono utilizzati dagli adattatori di controllo per eseguire il rendering dei collegamenti ipertestuali se è presente un adattatore di pagina derivato.
Il RenderPostBackEvent metodo esegue il rendering di un tag client di collegamento ipertestuale o postback che può inviare il modulo.
I RegisterRadioButton metodi e GetRadioButtonsByGroup vengono utilizzati dagli adattatori di controllo pulsante di opzione per fare riferimento agli altri RadioButton controlli in un gruppo di pulsanti di opzione.
La ClientState proprietà fornisce l'accesso agli stati di controllo e visualizzazione combinati dell'oggetto Page tramite la proprietà interna ClientState della Page classe .
Il TransformText metodo viene usato dagli adattatori di controllo per eseguire la trasformazione del testo specifica del dispositivo.

Costruttori

PageAdapter()

Inizializza una nuova istanza della classe PageAdapter.

Proprietà

Browser	Ottiene un riferimento alle funzionalità del browser del client che effettua la richiesta HTTP corrente. (Ereditato da ControlAdapter)
CacheVaryByHeaders	Ottiene un elenco di intestazioni HTTP aggiuntive che consentono di variare la memorizzazione nella cache per la pagina Web alla quale è collegato questo adattatore di pagina derivato.
CacheVaryByParams	Ottiene un elenco di parametri aggiuntivi dalle richieste HTTP GET e POST che variano la memorizzazione nella cache per la pagina Web alla quale è collegato questo adattatore di pagina derivato.
ClientState	Ottiene una stringa codificata che contiene i dati di visualizzazione e degli stati di controllo della pagina Web alla quale è associato questo adattatore di pagina derivato.
Control	Ottiene un riferimento al controllo a cui è collegato questo adattatore di controllo. (Ereditato da ControlAdapter)
Page	Ottiene un riferimento alla pagina in cui si trova il controllo associato a questo adattatore. (Ereditato da ControlAdapter)
PageAdapter	Ottiene un riferimento all'adattatore di pagina per la pagina in cui si trova il controllo associato. (Ereditato da ControlAdapter)

Metodi

BeginRender(HtmlTextWriter)	Questo metodo viene chiamato prima di effettuare il rendering di un controllo. In una classe di adattatore derivata, genera i tag di apertura richiesti da una destinazione specifica ma non necessari per i browser HTML. (Ereditato da ControlAdapter)
CreateChildControls()	Crea i controlli figlio specifici della destinazione per un controllo composito. (Ereditato da ControlAdapter)
DeterminePostBackMode()	Determina se la pagina Web è in postback e restituisce un insieme nome/valore delle variabili di postback.
DeterminePostBackModeUnvalidated()	Restituisce una raccolta nome-valore di dati inviata nella pagina utilizzando un comando POST o GET, senza eseguire la convalida delle richieste ASP.NET.
EndRender(HtmlTextWriter)	Questo metodo viene chiamato dopo il rendering di un controllo. In una classe di adattatore derivata, genera i tag di chiusura richiesti da una destinazione specifica ma non necessari per i browser HTML. (Ereditato da ControlAdapter)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetPostBackFormReference(String)	Restituisce un frammento di codice DHTML che può essere utilizzato dal browser client per fare riferimento al form nella pagina inserita.
GetRadioButtonsByGroup(String)	Recupera un insieme di controlli pulsante di opzione specificato da `groupName`.
GetStatePersister()	Restituisce un oggetto utilizzato dalla pagina Web per mantenere gli stati di controllo e visualizzazione.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadAdapterControlState(Object)	Carica le informazioni sullo stato di controllo dell'adattatore salvate dal metodo SaveAdapterControlState() durante una precedente richiesta alla pagina in cui si trova il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
LoadAdapterViewState(Object)	Carica le informazioni sullo stato di visualizzazione dell'adattatore salvate dal metodo SaveAdapterViewState() durante una precedente richiesta alla pagina in cui si trova il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnInit(EventArgs)	Esegue l'override del metodo OnInit(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnLoad(EventArgs)	Esegue l'override del metodo OnLoad(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnPreRender(EventArgs)	Esegue l'override del metodo OnPreRender(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnUnload(EventArgs)	Esegue l'override del metodo OnUnload(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
RegisterRadioButton(RadioButton)	Aggiunge un controllo pulsante di opzione all'insieme per un gruppo di pulsanti di opzione specificato.
Render(HtmlTextWriter)	Genera il markup specifico della destinazione per il controllo a cui è associato l'adattatore del controllo. (Ereditato da ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Esegue il rendering di un tag di apertura di collegamento ipertestuale che comprende l'URL di destinazione al flusso di risposta.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Esegue il rendering di un tag di apertura di collegamento ipertestuale che comprende l'URL di destinazione e un tasto di scelta al flusso di risposta.
RenderChildren(HtmlTextWriter)	Genera il markup specifico della destinazione per i controlli figlio in un controllo composito al quale è collegato l'adattatore del controllo. (Ereditato da ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)	Esegue il rendering di un tag di chiusura di collegamento ipertestuale sul flusso di risposta.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String)	Esegue il rendering di un evento di postback all'interno del flusso di risposta come un collegamento ipertestuale, compreso lo stato di visualizzazione codificato e possibilmente crittografato, oltre alla destinazione e all'argomento dell'evento.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Esegue il rendering di un evento di postback all'interno del flusso di risposta come un collegamento ipertestuale, compreso lo stato di visualizzazione codificato e possibilmente crittografato, la destinazione e l'argomento di un evento, un parametro di pagina precedente e un tasto di scelta.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Esegue il rendering di un evento di postback all'interno del flusso di risposta come un collegamento ipertestuale, compreso lo stato di visualizzazione codificato, la destinazione e l'argomento di un evento, un parametro di pagina precedente e un tasto di scelta.
SaveAdapterControlState()	Salva le informazioni sullo stato del controllo per l'adattatore del controllo. (Ereditato da ControlAdapter)
SaveAdapterViewState()	Salva le informazioni sullo stato di visualizzazione per l'adattatore del controllo. (Ereditato da ControlAdapter)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TransformText(String)	Trasforma il testo per il browser di destinazione.

Si applica a

Vedi anche

ControlAdapter