PageAdapter Klass

Definition

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

Arv

Object

ControlAdapter

PageAdapter

Exempel

Följande kodexempel visar hur du härleder en klass med namnet CustomPageAdapter från PageAdapter klassen och åsidosätter RenderBeginHyperlink metoden. Metoden RenderBeginHyperlink lägger till ett attribut med namnet src till en hyperlänk som innehåller en referens till den aktuella sidan. Alla hyperlänkar som återges på sidor som CustomPageAdapter är kopplade till har attributet 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

Kommentarer

Klassen PageAdapter är en abstrakt klass som anpassar en webbsida för en viss webbläsarklass, definierad av det påläggsspråk som webbläsaren använder (till exempel HTML eller XHTML). Mycket av anpassningsbarheten i återgivningsbeteendet kan kapslas in i de specialiserade textskrivareklasserna som härleds från HtmlTextWriter klassen, så det är inte alltid nödvändigt att tillhandahålla ett sidkort.

De flesta medlemmar i härledda sidkort anropas från Page klassen eller från kontrollkort. Page Först identifierar klass- eller kontrollkorten förekomsten av det härledda sidkortet och anropar sedan medlemmen eller anger funktionen om sidkortet inte finns.

Medlemmarna i PageAdapter klassen tillhandahåller följande funktioner:

• Egenskaperna CacheVaryByHeaders och CacheVaryByParams definierar ytterligare HTTP-huvuden och HTTP GET och POST parametrar som kan användas för att variera cachelagring. De anropas under cacheinitieringen från Page klassen.

• Metoden GetStatePersister returnerar ett objekt som kan användas för att bevara sidans kombinerade vy- och kontrolltillstånd. Den refereras från PageStatePersister egenskapen om det finns ett härlett sidkort.

• Metoden GetPostBackFormReference tillhandahåller ett DHTML-kodfragment som kan användas för att referera till formulär i skript.

• Metoden DeterminePostBackMode returnerar en samling av postback-variablerna om sidan är i postback. Den anropas av .NET Framework i stället för metoden Page.DeterminePostBackMode om det finns ett härlett sidkort.

• Metoderna RenderBeginHyperlink och RenderEndHyperlink används av kontrollkort för att återge hyperlänkar om det finns ett härlett sidkort.

• Metoden RenderPostBackEvent renderar en hyperlänk eller postback-klienttagg som kan skicka formuläret.

• Metoderna RegisterRadioButton och GetRadioButtonsByGroup används av radioknappkontrollkort för att referera till de andra RadioButton kontrollerna i en alternativknappsgrupp.

• Egenskapen ClientState ger åtkomst till objektets kombinerade kontroll- och vytillstånd Page via klassens ClientState interna Page egenskap.

• Metoden TransformText används av kontrollkort för att utföra enhetsspecifik texttransformering.

Se även

• ControlAdapter