PageAdapter Klas

Definitie

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

Overname

Object

ControlAdapter

PageAdapter

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een klasse kunt afleiden die is benoemd CustomPageAdapter uit de PageAdapter klasse en hoe u de RenderBeginHyperlink methode overschrijft. Met RenderBeginHyperlink de methode wordt een kenmerk met de naam src toegevoegd aan een hyperlink, dat een verwijzing naar de huidige pagina bevat. Alle hyperlinks die worden weergegeven op pagina's waaraan CustomPageAdapter is gekoppeld, hebben het src kenmerk.

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

Opmerkingen

De PageAdapter klasse is een abstracte klasse die een webpagina aanpast voor een specifieke klasse browsers, gedefinieerd door de opmaaktaal die door de browser wordt gebruikt (bijvoorbeeld HTML of XHTML). Veel van de aanpassingsvermogen in het weergavegedrag kan worden ingekapseld in de gespecialiseerde tekstschrijverklassen die zijn afgeleid van de HtmlTextWriter klasse, dus het is niet altijd nodig om een paginaadapter te bieden.

De meeste leden van afgeleide paginaadapters worden aangeroepen vanuit de Page klasse of van besturingsadapters. Eerst detecteren de Page klasse- of besturingsadapters de aanwezigheid van de afgeleide paginaadapter en roepen ze het lid aan of bieden ze de functionaliteit als de paginaadapter niet aanwezig is.

De leden van de PageAdapter klasse bieden de volgende functionaliteit:

• De CacheVaryByHeaders en CacheVaryByParams eigenschappen definiëren extra HTTP-headers en HTTP GET en POST parameters die kunnen worden gebruikt om caching te variëren. Ze worden aangeroepen tijdens de initialisatie van de cache vanuit de Page klasse.

• De GetStatePersister methode retourneert een object dat kan worden gebruikt om de gecombineerde weergave- en controlestatussen van de pagina te behouden. Er wordt naar verwezen vanuit de PageStatePersister eigenschap als er een afgeleide paginaadapter aanwezig is.

• De GetPostBackFormReference methode biedt een DHTML-codefragment dat kan worden gebruikt om te verwijzen naar formulieren in scripts.

• De DeterminePostBackMode methode retourneert een verzameling van de postback-variabelen als de pagina zich in postback bevindt. Het wordt aangeroepen door het .NET Framework in plaats van de methode Page.DeterminePostBackMode als er een afgeleide paginaadapter aanwezig is.

• De RenderBeginHyperlink en RenderEndHyperlink methoden worden gebruikt door besturingsadapters om hyperlinks weer te geven als er een afgeleide paginaadapter aanwezig is.

• Met de RenderPostBackEvent methode wordt een hyperlink- of postback-clienttag weergegeven waarmee het formulier kan worden verzonden.

• De RegisterRadioButton en GetRadioButtonsByGroup methoden worden gebruikt door keuzerondjes om te verwijzen naar de andere RadioButton besturingselementen in een keuzerondjegroep.

• De ClientState eigenschap biedt toegang tot de gecombineerde besturings- en weergavestatussen van het Page object via de interne ClientState eigenschap van de Page klasse.

• De TransformText methode wordt gebruikt door besturingsadapters om apparaatspecifieke teksttransformatie uit te voeren.

Zie ook

• ControlAdapter