PageAdapter Klasse

Definition

Namespace:

System.Web.UI.Adapters

Assembly:

System.Web.dll

Passt eine Webseite für einen bestimmten Browser an und stellt die Basisklasse bereit, die von allen Seitenadaptern direkt oder indirekt geerbt wird.

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

Vererbung

Object

ControlAdapter

PageAdapter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse mit dem Namen CustomPageAdapter der PageAdapter Klasse abgeleitet wird und die RenderBeginHyperlink Methode außer Kraft setzen kann. Die RenderBeginHyperlink Methode fügt einem Hyperlink ein Attribut src hinzu, das einen Verweis auf die aktuelle Seite enthält. Alle Links, die in Seiten gerendert werden, an die angefügt wird, CustomPageAdapter weisen das src Attribut auf.

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

Hinweise

Die PageAdapter Klasse ist eine abstrakte Klasse, die eine Webseite für eine bestimmte Browserklasse angepasst, die durch die Markupsprache definiert wird, die der Browser verwendet (z. B. HTML oder XHTML). Viele der Anpassungsfähigkeit im Renderingverhalten können in den spezialisierten Textautorklassen gekapselt werden, die von der HtmlTextWriter Klasse abgeleitet werden, sodass es nicht immer notwendig ist, einen Seitenadapter bereitzustellen.

Die meisten Elemente abgeleiteter Seitenadapter werden von der Page Klasse oder von Steuerelementadaptern aufgerufen. Zuerst erkennen die Page Klassen- oder Steuerelementadapter die Anwesenheit des abgeleiteten Seitenadapters, und rufen Sie dann das Element auf, oder geben Sie die Funktionalität an, wenn der Seitenadapter nicht vorhanden ist.

Die Elemente der PageAdapter Klasse stellen die folgenden Funktionen bereit:

• Die CacheVaryByHeaders Eigenschaften CacheVaryByParams definieren zusätzliche HTTP-Header und HTTP- und POST PARAMETERGET, die verwendet werden können, um zwischenspeichern zu können. Sie werden während der Cache-Initialisierung aus der Page Klasse aufgerufen.

• Die GetStatePersister Methode gibt ein Objekt zurück, das verwendet werden kann, um die kombinierten Ansichts- und Steuerelementzustände der Seite beizubehalten. Es wird von der PageStatePersister Eigenschaft verwiesen, wenn ein abgeleiteter Seitenadapter vorhanden ist.

• Die GetPostBackFormReference Methode stellt ein DHTML-Codefragment bereit, das zum Verweisen auf Formulare in Skripts verwendet werden kann.

• Die DeterminePostBackMode Methode gibt eine Auflistung der Postbackvariablen zurück, wenn sich die Seite im Postback befindet. Es wird vom .NET Framework anstelle der Page.DeterminePostBackMode Methode aufgerufen, wenn ein abgeleiteter Seitenadapter vorhanden ist.

• RenderEndHyperlink Die RenderBeginHyperlink Methoden werden von Steuerelementadaptern verwendet, um Hyperlinks zu rendern, wenn ein abgeleiteter Seitenadapter vorhanden ist.

• Die RenderPostBackEvent Methode rendert ein Link- oder Postbackclienttag, das das Formular übermitteln kann.

• Die RegisterRadioButton Methoden GetRadioButtonsByGroup und Methoden werden von Optionsschaltflächensteuerungsadaptern verwendet, um auf die anderen RadioButton Steuerelemente in einer Optionsschaltflächegruppe zu verweisen.

• Die ClientState Eigenschaft bietet Zugriff auf die kombinierten Steuerelement- und Ansichtszustände des Page Objekts über die interne ClientState Eigenschaft der Page Klasse.

• Die TransformText Methode wird von Steuerelementadaptern verwendet, um gerätespezifische Texttransformationen auszuführen.

Konstruktoren

PageAdapter()

Initialisiert eine neue Instanz der PageAdapter-Klasse.

Eigenschaften

Browser	Ruft einen Verweis auf die Browserfunktionen des Clients ab, durch den die aktuelle HTTP-Anforderung erfolgt. (Geerbt von ControlAdapter)
CacheVaryByHeaders	Ruft eine Liste zusätzlicher HTTP-Header ab, von denen die Zwischenspeicherung für die Webseite geändert wird, an die dieser abgeleitete Seitenadapter angefügt ist.
CacheVaryByParams	Ruft eine Liste zusätzlicher Parameter von HTTP GET- und HTTP POST-Anforderungen ab, von denen die Zwischenspeicherung für die Webseite geändert wird, an die dieser abgeleitete Seitenadapter angefügt ist.
ClientState	Ruft eine codierte Zeichenfolge mit den Daten zum Ansichts- und Steuerelementzustand der Webseite ab, an die dieser abgeleitete Seitenadapter angefügt ist.
Control	Ruft einen Verweis auf das Steuerelement ab, an das dieser Steuerelementadapter angefügt ist. (Geerbt von ControlAdapter)
Page	Ruft einen Verweis auf die Seite ab, auf der sich das diesem Adapter zugeordnete Steuerelement befindet. (Geerbt von ControlAdapter)
PageAdapter	Ruft einen Verweis auf den Seitenadapter für die Seite ab, auf der sich das zugeordnete Steuerelement befindet. (Geerbt von ControlAdapter)

Methoden

BeginRender(HtmlTextWriter)	Wird vor dem Rendering eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse öffnende Tags, die für ein bestimmtes Ziel erforderlich sind, von HTML-Browsern jedoch nicht benötigt werden. (Geerbt von ControlAdapter)
CreateChildControls()	Erstellt die zielspezifischen untergeordneten Steuerelemente für ein zusammengesetztes Steuerelement. (Geerbt von ControlAdapter)
DeterminePostBackMode()	Bestimmt, ob gerade ein Postback der Webseite ausgeführt wird und gibt eine Name-Wert-Auflistung der Postbackvariablen zurück.
DeterminePostBackModeUnvalidated()	Gibt eine Name/Wert-Datensammlung zurück, die der Seite mithilfe eines POST- oder GET-Befehls gesendet wurde, ohne bei der Anforderung eine ASP.NET-Anforderungsvalidierung durchzuführen.
EndRender(HtmlTextWriter)	Wird nach dem Rendering eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse schließende Tags, die für ein bestimmtes Ziel erforderlich sind, von HTML-Browsern jedoch nicht benötigt werden. (Geerbt von ControlAdapter)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPostBackFormReference(String)	Gibt ein DHTML-Codefragment zurück, mit dem der Clientbrowser auf das Formular auf der Seite verweisen kann, das gesendet wurde.
GetRadioButtonsByGroup(String)	Ruft eine Auflistung der von groupName angegebenen Optionsfeldsteuerelemente ab.
GetStatePersister()	Gibt ein Objekt zurück, das von der Webseite zum Beibehalten von Steuerelement- und Ansichtszustand verwendet wird.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadAdapterControlState(Object)	Lädt Steuerelementzustandsinformationen des Adapters, die von SaveAdapterControlState() während einer vorherigen Anforderung der Seite, auf der sich das diesem Steuerelementadapter zugeordnete Steuerelement befindet, gespeichert wurden. (Geerbt von ControlAdapter)
LoadAdapterViewState(Object)	Lädt Ansichtszustandsinformationen des Adapters, die von SaveAdapterViewState() während einer vorherigen Anforderung der Seite, auf der sich das diesem Steuerelementadapter zugeordnete Steuerelement befindet, gespeichert wurden. (Geerbt von ControlAdapter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnInit(EventArgs)	Überschreibt die OnInit(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnLoad(EventArgs)	Überschreibt die OnLoad(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnPreRender(EventArgs)	Überschreibt die OnPreRender(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnUnload(EventArgs)	Überschreibt die OnUnload(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
RegisterRadioButton(RadioButton)	Fügt der Auflistung für eine angegebene Optionsfeldgruppe ein Optionsfeldsteuerelement hinzu.
Render(HtmlTextWriter)	Generiert das zielspezifische Markup für das Steuerelement, an das der Steuerelementadapter angefügt ist. (Geerbt von ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Schreibt ein öffnendes Linktag, das die Ziel-URL enthält, in den Antwortstream.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Schreibt ein öffnendes Linktag mit der Ziel-URL sowie eine Zugriffstaste in den Antwortstream.
RenderChildren(HtmlTextWriter)	Generiert das zielspezifische Markup für die untergeordneten Steuerelemente in einem zusammengesetzten Steuerelement, an das der Steuerelementadapter angefügt ist. (Geerbt von ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)	Schreibt ein schließendes Linktag in den Antwortstream.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String)	Schreibt ein Postbackereignis, einschließlich des codierten und ggf. verschlüsselten Ansichtszustands sowie des Ereignisziels und -arguments, als Link in den Antwortstream.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Schreibt ein Postbackereignis, einschließlich des codierten und ggf. verschlüsselten Ansichtszustands, eines Ereignisziels und -arguments, eines Parameters für die vorherige Seite und einer Zugriffstaste, als Link in den Antwortstream.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Schreibt ein Postbackereignis, einschließlich des codierten Ansichtszustands, eines Ereignisziels und -arguments, eines Parameters für die vorherige Seite und einer Zugriffstaste, als Link in den Antwortstream.
SaveAdapterControlState()	Speichert Steuerelementzustandsinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
SaveAdapterViewState()	Speichert Ansichtszustandsinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TransformText(String)	Wandelt Text für den Zielbrowser um.

Siehe auch

• ControlAdapter