PageAdapter Třída

Definice

Obor názvů:

System.Web.UI.Adapters

Sestavení:

System.Web.dll

Přizpůsobí webovou stránku pro konkrétní prohlížeč a poskytuje základní třídu, ze které všechny adaptéry stránek dědí přímo nebo nepřímo.

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

Dědičnost

Object

ControlAdapter

PageAdapter

Příklady

Následující příklad kódu ukazuje, jak odvodit třídu pojmenovanou CustomPageAdapter z PageAdapter třídy a přepsat metodu RenderBeginHyperlink . Metoda RenderBeginHyperlink přidá atribut pojmenovaný src do hypertextového odkazu, který obsahuje odkaz na aktuální stránku. Všechny hypertextové odkazy vykreslené na stránkách, ke kterým CustomPageAdapter je připojen, budou mít src atribut.

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

Poznámky

Třída PageAdapter je abstraktní třída, která přizpůsobí webovou stránku pro konkrétní třídu prohlížečů definovaný jazykem značek, který prohlížeč používá (například HTML nebo XHTML). Většinu adaptability při vykreslování chování lze zapouzdřit ve specializovaných třídách textového HtmlTextWriter zapisovače, které jsou odvozeny od třídy, takže není vždy nutné poskytnout adaptér stránky.

Většina členů odvozených adaptérů stránky se volá z Page třídy nebo z ovládacích adaptérů. Page Nejprve třídy nebo ovládací adaptéry zjistí přítomnost odvozeného adaptéru stránky a potom zavolá člena nebo poskytne funkce, pokud adaptér stránky není k dispozici.

Členové PageAdapter třídy poskytují následující funkce:

• CacheVaryByParams Vlastnosti CacheVaryByHeaders definují další hlavičky HTTP a parametry HTTPGET, POST které lze použít k různým ukládáním do mezipaměti. Volají se během inicializace mezipaměti z Page třídy.

• Metoda GetStatePersister vrátí objekt, který lze použít k zachování kombinovaného zobrazení a kontrolních stavů stránky. Odkazuje se z PageStatePersister vlastnosti, pokud je k dispozici odvozený adaptér stránky.

• Metoda GetPostBackFormReference poskytuje fragment kódu DHTML, který lze použít k odkazování na formuláře ve skriptech.

• Metoda DeterminePostBackMode vrátí kolekci proměnných postback, pokud je stránka v postbacku. Volá se .NET Framework místo Page.DeterminePostBackMode metody, pokud je k dispozici odvozený adaptér stránky.

• Metody RenderBeginHyperlink a RenderEndHyperlink metody se používají ovládacími adaptéry k vykreslení hypertextových odkazů, pokud je k dispozici odvozený adaptér stránky.

• Metoda RenderPostBackEvent vykreslí hypertextový odkaz nebo značku klienta postback, která může odeslat formulář.

• Metody RegisterRadioButton a GetRadioButtonsByGroup metody se používají ovládacími adaptéry přepínačů k odkazům na ostatní RadioButton ovládací prvky ve skupině přepínačů.

• Vlastnost ClientState poskytuje přístup ke kombinovanému ovládacímu prvku a zobrazení stavů Page objektu prostřednictvím vnitřní ClientState vlastnosti Page třídy.

• Metoda TransformText se používá ovládacími adaptéry k provádění transformace textu specifického pro zařízení.

Konstruktory

PageAdapter()

Inicializuje novou instanci PageAdapter třídy.

Vlastnosti

Browser	Získá odkaz na možnosti prohlížeče klienta, který provádí aktuální požadavek HTTP. (Zděděno od ControlAdapter)
CacheVaryByHeaders	Získá seznam dalších hlaviček HTTP, pomocí kterých se ukládání do mezipaměti liší pro webovou stránku, ke které je připojen tento odvozený adaptér stránky.
CacheVaryByParams	Získá seznam dalších parametrů z požadavků HTTP GET a POST, pomocí kterých je ukládání do mezipaměti pro webovou stránku, ke které je připojen tento odvozený adaptér stránky.
ClientState	Získá kódovaný řetězec, který obsahuje zobrazení a ovládací prvek uvádí data webové stránky, ke které je tento odvozený adaptér stránky připojen.
Control	Získá odkaz na ovládací prvek, ke kterému je tento ovládací adaptér připojen. (Zděděno od ControlAdapter)
Page	Získá odkaz na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru. (Zděděno od ControlAdapter)
PageAdapter	Získá odkaz na adaptér stránky pro stránku, kde se nachází přidružený ovládací prvek. (Zděděno od ControlAdapter)

Metody

BeginRender(HtmlTextWriter)	Volá se před vykreslováním ovládacího prvku. V odvozené třídě adaptéru vygeneruje otevírání značek, které jsou vyžadovány konkrétním cílem, ale nejsou potřeba prohlížeči HTML. (Zděděno od ControlAdapter)
CreateChildControls()	Vytvoří podřízené ovládací prvky specifické pro cíl pro složený ovládací prvek. (Zděděno od ControlAdapter)
DeterminePostBackMode()	Určuje, zda je webová stránka v postbacku a vrátí kolekci názvů a hodnot proměnných postback.
DeterminePostBackModeUnvalidated()	Vrátí kolekci dat názvových hodnot, která byla odeslána na stránku pomocí příkazu POST nebo GET, aniž by bylo nutné provést ověření požadavku na požadavek ASP.NET.
EndRender(HtmlTextWriter)	Volá se po vykreslení ovládacího prvku. V odvozené třídě adaptéru generuje uzavírací značky, které jsou vyžadovány konkrétním cílem, ale nejsou potřeba prohlížeči HTML. (Zděděno od ControlAdapter)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetPostBackFormReference(String)	Vrátí fragment kódu DHTML, který může klientský prohlížeč použít k odkazu na formulář na stránce, která byla publikována.
GetRadioButtonsByGroup(String)	Načte kolekci ovládacích prvků přepínačů určených uživatelem groupName.
GetStatePersister()	Vrátí objekt, který webová stránka používá k zachování stavu ovládacího prvku a zobrazení.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
LoadAdapterControlState(Object)	Načte informace o stavu řízení adaptéru uložené SaveAdapterControlState() během předchozího požadavku na stránku, na které je ovládací prvek přidružený k tomuto řídicímu adaptéru. (Zděděno od ControlAdapter)
LoadAdapterViewState(Object)	Načte informace o stavu zobrazení adaptéru uložené SaveAdapterViewState() během předchozího požadavku na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnInit(EventArgs)	Přepíše metodu OnInit(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnLoad(EventArgs)	Přepíše metodu OnLoad(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnPreRender(EventArgs)	Přepíše metodu OnPreRender(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnUnload(EventArgs)	Přepíše metodu OnUnload(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
RegisterRadioButton(RadioButton)	Přidá ovládací prvek přepínače do kolekce pro zadanou skupinu přepínačů.
Render(HtmlTextWriter)	Vygeneruje cílovou značku pro ovládací prvek, ke kterému je připojený řídicí adaptér. (Zděděno od ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Vykreslí levou značku hypertextového odkazu, která obsahuje cílovou adresu URL streamu odpovědí.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Vykreslí levou značku hypertextového odkazu, která obsahuje cílovou adresu URL a přístupový klíč pro stream odpovědí.
RenderChildren(HtmlTextWriter)	Vygeneruje značku specifickou pro cíl pro podřízené ovládací prvky ve složeném ovládacím prvku, ke kterému je ovládací adaptér připojený. (Zděděno od ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)	Vykreslí pravou značku hypertextového odkazu do streamu odpovědí.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String)	Vykreslí událost postback do streamu odpovědí jako hypertextový odkaz, včetně zakódovaného a pravděpodobně šifrovaného stavu zobrazení a cíle a argumentu události.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Vykreslí událost postback do streamu odpovědí jako hypertextový odkaz, včetně zakódovaného a pravděpodobně šifrovaného stavu zobrazení, cíle události a argumentu, parametru předchozí stránky a přístupového klíče.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Vykreslí událost postback do streamu odpovědí jako hypertextový odkaz, včetně zakódovaného stavu zobrazení, cíle události a argumentu, parametru předchozí stránky a přístupového klíče.
SaveAdapterControlState()	Uloží informace o stavu ovládacího prvku pro adaptér ovládacího prvku. (Zděděno od ControlAdapter)
SaveAdapterViewState()	Uloží informace o stavu ovládacího adaptéru. (Zděděno od ControlAdapter)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TransformText(String)	Transformuje text pro cílový prohlížeč.

Viz také

• ControlAdapter