PageAdapter Classe

Définition

Adapte une page Web pour un navigateur spécifique et fournit la classe de base de laquelle tous les adaptateurs de page héritent, directement ou indirectement.Adapts a Web page for a specific browser and provides the base class from which all page adapters inherit, directly or indirectly.

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
Héritage
PageAdapter

Exemples

L’exemple de code suivant montre comment dériver une classe CustomPageAdapter nommée de PageAdapter la classe et substituer RenderBeginHyperlink la méthode.The following code example demonstrates how to derive a class named CustomPageAdapter from the PageAdapter class and override the RenderBeginHyperlink method. La RenderBeginHyperlink méthode ajoute un attribut nommé src à un lien hypertexte, qui contient une référence à la page active.The RenderBeginHyperlink method adds an attribute named src to a hyperlink, which contains a reference to the current page. Tous les liens hypertexte restitués dans les pages CustomPageAdapter auxquelles est attaché auront l' src attribut.All hyperlinks rendered in pages to which CustomPageAdapter is attached will have the src attribute.

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

Remarques

La PageAdapter classe est une classe abstraite qui adapte une page Web pour une classe spécifique de navigateurs, définie par le langage de balisage utilisé par le navigateur (par exemple, html ou XHTML).The PageAdapter class is an abstract class that adapts a Web page for a specific class of browsers, defined by the markup language that the browser uses (for example, HTML or XHTML). Une grande partie de l’adaptabilité du comportement de rendu peut être encapsulée dans les classes de writer de texte HtmlTextWriter spécialisées qui dérivent de la classe, donc il n’est pas toujours nécessaire de fournir un adaptateur de page.Much of the adaptability in rendering behavior can be encapsulated in the specialized text writer classes that derive from the HtmlTextWriter class, so it is not always necessary to provide a page adapter.

La plupart des membres des adaptateurs de page dérivés Page sont appelés à partir de la classe ou des adaptateurs de contrôle.Most members of derived page adapters are called from the Page class or from control adapters. Tout d’abord Page , les adaptateurs de classe ou de contrôle détectent la présence de l’adaptateur de page dérivé, puis appellent le membre ou fournissent les fonctionnalités si l’adaptateur de page n’est pas présent.First, the Page class or control adapters detect the presence of the derived page adapter, and then call the member, or provide the functionality if the page adapter is not present.

Les membres de la PageAdapter classe fournissent les fonctionnalités suivantes:The members of the PageAdapter class provide the following functionality:

  • Les CacheVaryByHeaders propriétés CacheVaryByParams et définissent des en-têtes GET http POST supplémentaires et des paramètres http et qui peuvent être utilisés pour faire varier la mise en cache.The CacheVaryByHeaders and CacheVaryByParams properties define additional HTTP headers and HTTP GET and POST parameters that can be used to vary caching. Elles sont appelées pendant l’initialisation du cache Page à partir de la classe.They are called during cache initialization from the Page class.

  • La GetStatePersister méthode retourne un objet qui peut être utilisé pour rendre persistantes les États de contrôle et d’affichage combinés de la page.The GetStatePersister method returns an object that can be used to persist the combined view and control states of the page. Elle est référencée à partir PageStatePersister de la propriété si un adaptateur de page dérivé est présent.It is referenced from the PageStatePersister property if a derived page adapter is present.

  • La GetPostBackFormReference méthode fournit un fragment de code DHTML qui peut être utilisé pour référencer des formulaires dans des scripts.The GetPostBackFormReference method provides a DHTML code fragment that can be used to reference forms in scripts.

  • La DeterminePostBackMode méthode retourne une collection des variables de publication (postback) si la page est dans la publication (postback).The DeterminePostBackMode method returns a collection of the postback variables if the page is in postback. Elle est appelée par la .NET Framework au lieu de Page.DeterminePostBackMode la méthode si un adaptateur de page dérivé est présent.It is called by the .NET Framework instead of the Page.DeterminePostBackMode method if a derived page adapter is present.

  • Les RenderBeginHyperlink méthodes RenderEndHyperlink et sont utilisées par les adaptateurs de contrôle pour restituer des liens hypertexte si un adaptateur de page dérivé est présent.The RenderBeginHyperlink and RenderEndHyperlink methods are used by control adapters to render hyperlinks if a derived page adapter is present.

  • La RenderPostBackEvent méthode restitue un lien hypertexte ou une balise cliente de publication qui peut envoyer le formulaire.The RenderPostBackEvent method renders a hyperlink or postback client tag that can submit the form.

  • Les RegisterRadioButton méthodes GetRadioButtonsByGroup et sont utilisées par les adaptateurs de contrôle de case d’option RadioButton pour référencer les autres contrôles dans un groupe de cases d’option.The RegisterRadioButton and GetRadioButtonsByGroup methods are used by radio button control adapters to reference the other RadioButton controls in a radio button group.

  • La ClientState propriété fournit l’accès aux États de contrôle et d’affichage combinés Page de l’objet via ClientState la propriété interne Page de la classe.The ClientState property provides access to the combined control and view states of the Page object through the internal ClientState property of the Page class.

  • La TransformText méthode est utilisée par les adaptateurs de contrôle pour effectuer une transformation de texte spécifique à l’appareil.The TransformText method is used by control adapters to perform device-specific text transformation.

Constructeurs

PageAdapter()

Initialise une nouvelle instance de la classe PageAdapter.Initializes a new instance of the PageAdapter class.

Propriétés

Browser

Reçoit une référence aux fonctionnalités de navigation du client effectuant la demande HTTP en cours.Gets a reference to the browser capabilities of the client making the current HTTP request.

(Hérité de ControlAdapter)
CacheVaryByHeaders

Obtient une liste d'en-têtes HTTP supplémentaires permettant la variation de la mise en cache pour la page Web à laquelle cet adaptateur de page dérivé est attaché.Gets a list of additional HTTP headers by which caching is varied for the Web page to which this derived page adapter is attached.

CacheVaryByParams

Obtient une liste de paramètres supplémentaires à partir des demandes HTTP GET et POST permettant la variation de la mise en cache pour la page Web à laquelle cet adaptateur de page dérivé est attaché.Gets a list of additional parameters from HTTP GET and POST requests by which caching is varied for the Web page to which this derived page adapter is attached.

ClientState

Obtient une chaîne encodée qui contient les données d'états de contrôle et d'affichage de la page Web à laquelle cet adaptateur de page dérivé est attaché.Gets an encoded string that contains the view and control states data of the Web page to which this derived page adapter is attached.

Control

Reçoit une référence au contrôle auquel cet adaptateur de contrôles est joint.Gets a reference to the control to which this control adapter is attached.

(Hérité de ControlAdapter)
Page

Reçoit une référence à la page sur laquelle réside le contrôle associé à cet adaptateur.Gets a reference to the page where the control associated with this adapter resides.

(Hérité de ControlAdapter)
PageAdapter

Reçoit une référence à l'adaptateur de page pour la page sur laquelle réside le contrôle associé.Gets a reference to the page adapter for the page where the associated control resides.

(Hérité de ControlAdapter)

Méthodes

BeginRender(HtmlTextWriter)

Appelé avant le rendu d'un contrôle.Called prior to the rendering of a control. Dans une classe d'adaptateur dérivée, génère des balises d'ouverture requises par une cible spécifique mais pas par les navigateurs HTML.In a derived adapter class, generates opening tags that are required by a specific target but not needed by HTML browsers.

(Hérité de ControlAdapter)
CreateChildControls()

Crée les contrôles enfants spécifiques à la cible pour un contrôle composite.Creates the target-specific child controls for a composite control.

(Hérité de ControlAdapter)
DeterminePostBackMode()

Détermine si la page Web est en cours de publication et retourne une collection de noms/valeurs pour les variables de publication.Determines whether the Web page is in postback and returns a name/value collection of the postback variables.

DeterminePostBackModeUnvalidated()

Retourne une collection de données nom-valeur qui a été publiée dans la page à l'aide d'une commande POST ou GET, sans effectuer la validation de demande ASP.NET sur la demande.Returns a name-value collection of data that was posted to the page using either a POST or a GET command, without performing ASP.NET request validation on the request.

EndRender(HtmlTextWriter)

Appelé après le rendu d'un contrôle.Called after the rendering of a control. Dans une classe d'adaptateur dérivée, génère des balises de fermeture requises par une cible spécifique mais pas par les navigateurs HTML.In a derived adapter class, generates closing tags that are required by a specific target but not needed by HTML browsers.

(Hérité de ControlAdapter)
Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetPostBackFormReference(String)

Retourne un fragment de code DHTML que le navigateur client peut utiliser pour référencer le formulaire sur la page qui a été publiée.Returns a DHTML code fragment that the client browser can use to reference the form on the page that was posted.

GetRadioButtonsByGroup(String)

Récupère une collection de contrôles de case d'option spécifiée par groupName.Retrieves a collection of radio button controls specified by groupName.

GetStatePersister()

Retourne un objet qui est utilisé par la page Web pour maintenir les états de contrôle et d'affichage.Returns an object that is used by the Web page to maintain the control and view states.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
LoadAdapterControlState(Object)

Charge des informations sur l'état du contrôle d'adaptateur qui ont été enregistrées par SaveAdapterControlState(), lors d'une demande antérieure, sur la page sur laquelle réside le contrôle associé à cet adaptateur de contrôles.Loads adapter control state information that was saved by SaveAdapterControlState() during a previous request to the page where the control associated with this control adapter resides.

(Hérité de ControlAdapter)
LoadAdapterViewState(Object)

Charge des informations sur l'état d'affichage de l'adaptateur qui ont été enregistrées par SaveAdapterViewState(), lors d'une demande antérieure, sur la page sur laquelle réside le contrôle associé à cet adaptateur de contrôles.Loads adapter view state information that was saved by SaveAdapterViewState() during a previous request to the page where the control associated with this control adapter resides.

(Hérité de ControlAdapter)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnInit(EventArgs)

Substitue la méthode OnInit(EventArgs) au contrôle associé.Overrides the OnInit(EventArgs) method for the associated control.

(Hérité de ControlAdapter)
OnLoad(EventArgs)

Substitue la méthode OnLoad(EventArgs) au contrôle associé.Overrides the OnLoad(EventArgs) method for the associated control.

(Hérité de ControlAdapter)
OnPreRender(EventArgs)

Substitue la méthode OnPreRender(EventArgs) au contrôle associé.Overrides the OnPreRender(EventArgs) method for the associated control.

(Hérité de ControlAdapter)
OnUnload(EventArgs)

Substitue la méthode OnUnload(EventArgs) au contrôle associé.Overrides the OnUnload(EventArgs) method for the associated control.

(Hérité de ControlAdapter)
RegisterRadioButton(RadioButton)

Ajoute un contrôle de case d'option à la collection pour un groupe de cases d'option spécifié.Adds a radio button control to the collection for a specified radio button group.

Render(HtmlTextWriter)

Génère le balisage spécifique à la cible pour le contrôle auquel l’adaptateur de contrôle est attaché.Generates the target-specific markup for the control to which the control adapter is attached.

(Hérité de ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Restitue une balise d'ouverture de lien hypertexte qui inclut l'URL cible au flux de réponse.Renders an opening hyperlink tag that includes the target URL to the response stream.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

Restitue une balise d'ouverture de lien hypertexte qui inclut l'URL cible et une touche d'accès rapide au flux de réponse.Renders an opening hyperlink tag that includes the target URL and an access key to the response stream.

RenderChildren(HtmlTextWriter)

Génère la balise spécifique à la cible pour les contrôles enfants dans un contrôle composite auquel l'adaptateur de contrôles est joint.Generates the target-specific markup for the child controls in a composite control to which the control adapter is attached.

(Hérité de ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)

Restitue une balise de fermeture de lien hypertexte au flux de réponse.Renders a closing hyperlink tag to the response stream.

RenderPostBackEvent(HtmlTextWriter, String, String, String, String)

Restitue un événement de publication dans le flux de réponse en tant que lien hypertexte, y compris l'état d'affichage encodé éventuellement chiffré, la cible et l'argument d'événement.Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, and event target and argument.

RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)

Restitue un événement de publication dans le flux de réponse en tant que lien hypertexte, y compris l'état d'affichage encodé éventuellement chiffré, une cible et un argument d'événement, un paramètre de page précédente et une touche d'accès rapide.Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, an event target and argument, a previous-page parameter, and an access key.

RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)

Restitue un événement de publication dans le flux de réponse en tant que lien hypertexte, y compris l'état d'affichage encodé, une cible et un argument d'événement, un paramètre de page précédente et une touche d'accès rapide.Renders a postback event into the response stream as a hyperlink, including the encoded view state, an event target and argument, a previous-page parameter, and an access key.

SaveAdapterControlState()

Enregistre les informations sur l'état de contrôle pour l'adaptateur de contrôles.Saves control state information for the control adapter.

(Hérité de ControlAdapter)
SaveAdapterViewState()

Enregistre les informations sur l'état d'affichage pour l'adaptateur de contrôles.Saves view state information for the control adapter.

(Hérité de ControlAdapter)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
TransformText(String)

Transforme le texte pour le navigateur cible.Transforms text for the target browser.

S’applique à

Voir aussi