PageAdapter Classe

Definizione

Adatta una pagina Web per un browser specifico e fornisce la classe base dalla quale ereditano tutti gli adattatori di pagina, direttamente o indirettamente.Adapts a Web page for a specific browser and provides the base class from which all page adapters inherit, directly or indirectly.

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à
PageAdapter

Esempi

Nell'esempio di codice seguente viene illustrato come derivare una CustomPageAdapter classe denominata PageAdapter dalla classe ed eseguire RenderBeginHyperlink l'override del metodo.The following code example demonstrates how to derive a class named CustomPageAdapter from the PageAdapter class and override the RenderBeginHyperlink method. Il RenderBeginHyperlink metodo aggiunge un attributo denominato src a un collegamento ipertestuale, che contiene un riferimento alla pagina corrente.The RenderBeginHyperlink method adds an attribute named src to a hyperlink, which contains a reference to the current page. Tutti i collegamenti ipertestuali sottoposti a rendering CustomPageAdapter nelle pagine a cui è src collegato avranno l'attributo.All hyperlinks rendered in pages to which CustomPageAdapter is attached will have the src attribute.

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 utilizzato dal browser (ad esempio, HTML o XHTML).The PageAdapter class is an abstract class that adapts a Web page for a specific class of browsers, defined by the markup language that the browser uses (for example, HTML or XHTML). Gran parte dell'adattamento del comportamento di rendering può essere incapsulato nelle classi di writer di testo specializzate che derivano dalla HtmlTextWriter classe, quindi non è sempre necessario fornire un adattatore di pagina.Much of the adaptability in rendering behavior can be encapsulated in the specialized text writer classes that derive from the HtmlTextWriter class, so it is not always necessary to provide a page adapter.

La maggior parte dei membri degli adattatori di pagina Page derivati viene chiamata dalla classe o dagli adattatori di controllo.Most members of derived page adapters are called from the Page class or from control adapters. In primo luogo Page , gli adattatori di classe o di controllo rilevano la presenza dell'adattatore di pagina derivato, quindi chiamano il membro o forniscono la funzionalità se l'adattatore di pagina non è presente.First, the Page class or control adapters detect the presence of the derived page adapter, and then call the member, or provide the functionality if the page adapter is not present.

I membri della PageAdapter classe forniscono le funzionalità seguenti:The members of the PageAdapter class provide the following functionality:

  • Le CacheVaryByHeaders proprietà CacheVaryByParams e definiscono GET intestazioniPOST http e parametri http aggiuntivi che possono essere usati per variare la memorizzazione nella cache.The CacheVaryByHeaders and CacheVaryByParams properties define additional HTTP headers and HTTP GET and POST parameters that can be used to vary caching. Vengono chiamati durante l' Page inizializzazione della cache dalla classe.They are called during cache initialization from the Page class.

  • Il GetStatePersister metodo restituisce un oggetto che può essere usato per salvare in modo permanente gli Stati di visualizzazione e controllo combinati della pagina.The GetStatePersister method returns an object that can be used to persist the combined view and control states of the page. Viene fatto riferimento dalla PageStatePersister proprietà se è presente un adattatore di pagina derivato.It is referenced from the PageStatePersister property if a derived page adapter is present.

  • Il GetPostBackFormReference metodo fornisce un frammento di codice DHTML che può essere utilizzato per fare riferimento ai form negli script.The GetPostBackFormReference method provides a DHTML code fragment that can be used to reference forms in scripts.

  • Il DeterminePostBackMode metodo restituisce una raccolta delle variabili di postback se la pagina è in postback.The DeterminePostBackMode method returns a collection of the postback variables if the page is in postback. Viene chiamato dal .NET Framework invece Page.DeterminePostBackMode che dal metodo se è presente un adattatore di pagina derivato.It is called by the .NET Framework instead of the Page.DeterminePostBackMode method if a derived page adapter is present.

  • I RenderBeginHyperlink metodi RenderEndHyperlink e vengono utilizzati dagli adattatori di controllo per eseguire il rendering dei collegamenti ipertestuali se è presente un adattatore di pagina derivato.The RenderBeginHyperlink and RenderEndHyperlink methods are used by control adapters to render hyperlinks if a derived page adapter is present.

  • Il RenderPostBackEvent metodo esegue il rendering di un collegamento ipertestuale o un tag client di postback che può inviare il modulo.The RenderPostBackEvent method renders a hyperlink or postback client tag that can submit the form.

  • I RegisterRadioButton metodi GetRadioButtonsByGroup e vengono utilizzati dagli adattatori di controllo pulsante di opzione per RadioButton fare riferimento ad altri controlli in un gruppo di pulsanti di opzione.The RegisterRadioButton and GetRadioButtonsByGroup methods are used by radio button control adapters to reference the other RadioButton controls in a radio button group.

  • La ClientState proprietà fornisce l'accesso agli stati Page di controllo e visualizzazione combinati dell'oggetto tramite Page la ClientState proprietà interna della classe.The ClientState property provides access to the combined control and view states of the Page object through the internal ClientState property of the Page class.

  • Il TransformText metodo viene utilizzato dagli adattatori di controllo per eseguire la trasformazione del testo specifica del dispositivo.The TransformText method is used by control adapters to perform device-specific text transformation.

Costruttori

PageAdapter()

Inizializza una nuova istanza della classe PageAdapter.Initializes a new instance of the PageAdapter class.

Proprietà

Browser

Ottiene un riferimento alle funzionalità del browser del client che effettua la richiesta HTTP corrente.Gets a reference to the browser capabilities of the client making the current HTTP request.

(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.Gets a list of additional HTTP headers by which caching is varied for the Web page to which this derived page adapter is attached.

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.Gets a list of additional parameters from HTTP GET and POST requests by which caching is varied for the Web page to which this derived page adapter is attached.

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.Gets an encoded string that contains the view and control states data of the Web page to which this derived page adapter is attached.

Control

Ottiene un riferimento al controllo a cui è collegato questo adattatore di controllo.Gets a reference to the control to which this control adapter is attached.

(Ereditato da ControlAdapter)
Page

Ottiene un riferimento alla pagina in cui si trova il controllo associato a questo adattatore.Gets a reference to the page where the control associated with this adapter resides.

(Ereditato da ControlAdapter)
PageAdapter

Ottiene un riferimento all'adattatore di pagina per la pagina in cui si trova il controllo associato.Gets a reference to the page adapter for the page where the associated control resides.

(Ereditato da ControlAdapter)

Metodi

BeginRender(HtmlTextWriter)

Questo metodo viene chiamato prima di effettuare il rendering di un controllo.Called prior to the rendering of a control. In una classe di adattatore derivata, genera i tag di apertura richiesti da una destinazione specifica ma non necessari per i browser HTML.In a derived adapter class, generates opening tags that are required by a specific target but not needed by HTML browsers.

(Ereditato da ControlAdapter)
CreateChildControls()

Crea i controlli figlio specifici della destinazione per un controllo composito.Creates the target-specific child controls for a composite control.

(Ereditato da ControlAdapter)
DeterminePostBackMode()

Determina se la pagina Web è in postback e restituisce un insieme nome/valore delle variabili di postback.Determines whether the Web page is in postback and returns a name/value collection of the postback variables.

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.Returns a name-value collection of data that was posted to the page using either a POST or a GET command, without performing ASP.NET request validation on the request.

EndRender(HtmlTextWriter)

Questo metodo viene chiamato dopo il rendering di un controllo.Called after the rendering of a control. In una classe di adattatore derivata, genera i tag di chiusura richiesti da una destinazione specifica ma non necessari per i browser HTML.In a derived adapter class, generates closing tags that are required by a specific target but not needed by HTML browsers.

(Ereditato da ControlAdapter)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(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.Returns a DHTML code fragment that the client browser can use to reference the form on the page that was posted.

GetRadioButtonsByGroup(String)

Recupera un insieme di controlli pulsante di opzione specificato da groupName.Retrieves a collection of radio button controls specified by groupName.

GetStatePersister()

Restituisce un oggetto utilizzato dalla pagina Web per mantenere gli stati di controllo e visualizzazione.Returns an object that is used by the Web page to maintain the control and view states.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(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.Loads adapter control state information that was saved by SaveAdapterControlState() during a previous request to the page where the control associated with this control adapter resides.

(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.Loads adapter view state information that was saved by SaveAdapterViewState() during a previous request to the page where the control associated with this control adapter resides.

(Ereditato da ControlAdapter)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnInit(EventArgs)

Esegue l'override del metodo OnInit(EventArgs) per il controllo associato.Overrides the OnInit(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
OnLoad(EventArgs)

Esegue l'override del metodo OnLoad(EventArgs) per il controllo associato.Overrides the OnLoad(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
OnPreRender(EventArgs)

Esegue l'override del metodo OnPreRender(EventArgs) per il controllo associato.Overrides the OnPreRender(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
OnUnload(EventArgs)

Esegue l'override del metodo OnUnload(EventArgs) per il controllo associato.Overrides the OnUnload(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
RegisterRadioButton(RadioButton)

Aggiunge un controllo pulsante di opzione all'insieme per un gruppo di pulsanti di opzione specificato.Adds a radio button control to the collection for a specified radio button group.

Render(HtmlTextWriter)

Genera il markup specifico della destinazione per il controllo a cui è associato l'adattatore del controllo.Generates the target-specific markup for the control to which the control adapter is attached.

(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.Renders an opening hyperlink tag that includes the target URL to the response stream.

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.Renders an opening hyperlink tag that includes the target URL and an access key to the response stream.

RenderChildren(HtmlTextWriter)

Genera il markup specifico della destinazione per i controlli figlio in un controllo composito al quale è collegato l'adattatore del controllo.Generates the target-specific markup for the child controls in a composite control to which the control adapter is attached.

(Ereditato da ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)

Esegue il rendering di un tag di chiusura di collegamento ipertestuale sul flusso di risposta.Renders a closing hyperlink tag to the response stream.

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.Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, and event target and argument.

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.Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, an event target and argument, a previous-page parameter, and an access key.

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.Renders a postback event into the response stream as a hyperlink, including the encoded view state, an event target and argument, a previous-page parameter, and an access key.

SaveAdapterControlState()

Salva le informazioni sullo stato del controllo per l'adattatore del controllo.Saves control state information for the control adapter.

(Ereditato da ControlAdapter)
SaveAdapterViewState()

Salva le informazioni sullo stato di visualizzazione per l'adattatore del controllo.Saves view state information for the control adapter.

(Ereditato da ControlAdapter)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TransformText(String)

Trasforma il testo per il browser di destinazione.Transforms text for the target browser.

Si applica a

Vedi anche