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řipojeno, 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

PageAdapter Třída je abstraktní třída, která přizpůsobuje webovou stránku pro konkrétní třídu prohlížečů definovaný jazykem revizí, který prohlížeč používá (například HTML nebo XHTML). Většinu přizpůsobitelnosti chování vykreslování lze zapouzdřit ve specializovaných třídách zapisovače textu, které jsou odvozeny od HtmlTextWriter 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 řídicích adaptérů. Page Nejprve adaptéry třídy nebo ovládacího prvku zjistí přítomnost odvozeného adaptéru stránky a potom volají člena nebo poskytují 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 GET http a POST parametry, které se dají použít k ukládání do mezipaměti. Volá 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 postback proměnných, pokud je stránka v postbacku. Je volána rozhraním .NET Framework místo Page.DeterminePostBackMode metody, pokud je k dispozici odvozený adaptér stránky.

• Tyto RenderBeginHyperlink a RenderEndHyperlink metody používají adaptéry ovládacích prvků 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ář.

• GetRadioButtonsByGroup Ovládací RegisterRadioButton adaptéry přepínačů a metod se používají k odkazu 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 provedení transformace textu specifické pro zařízení.

Konstruktory

Name	Description
PageAdapter()	Inicializuje novou instanci PageAdapter třídy.

Vlastnosti

Name	Description
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, které ukládání do mezipaměti se 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, které ukládání do mezipaměti se liší 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 adaptér ovládacího prvku 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

Name	Description
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 v prohlížečích 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, která byla odeslána na stránku pomocí příkazu POST nebo GET, bez provedení ASP.NET ověření požadavku na požadavek.
EndRender(HtmlTextWriter)	Volá se po vykreslení ovládacího prvku. V odvozené třídě adaptéru vygeneruje koncové značky, které jsou vyžadovány konkrétním cílem, ale nejsou potřeba v prohlížečích HTML. (Zděděno od ControlAdapter)
Equals(Object)	Určuje, zda je zadaný objekt roven 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, pomocí kterého může klientský prohlížeč odkazovat na formulář na publikované stránce.
GetRadioButtonsByGroup(String)	Načte kolekci ovládacích prvků přepínačů určených parametrem groupName.
GetStatePersister()	Vrátí objekt, který webová stránka používá k udržování stavu ovládacího prvku a zobrazení.
GetType()	Získá Type aktuální instance. (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, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (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ří mělkou kopii aktuálního 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č do kolekce pro zadanou skupinu přepínačů.
Render(HtmlTextWriter)	Vygeneruje cílovou značku pro ovládací prvek, ke kterému je adaptér ovládacího prvku připojen. (Zděděno od ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Vykreslí počáteční značku hypertextového odkazu, která obsahuje cílovou adresu URL a přístupový klíč ke streamu odpovědí.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Vykreslí počáteční značku hypertextového odkazu, která obsahuje cílovou adresu URL streamu odpovědi.
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 adaptér ovládacího prvku připojen. (Zděděno od ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)	Vykreslí pravou značku hypertextového odkazu do streamu odpovědi.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Vykreslí událost postback do streamu odpovědi 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.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Vykreslí událost postback do streamu odpovědi jako hypertextový odkaz, včetně zakódovaného a případně š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)	Vykreslí událost postback do streamu odpovědi jako hypertextový odkaz, včetně zakódovaného a případně šifrovaného stavu zobrazení a cíle a argumentu události.
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 řídicí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