PageAdapter Classe

Référence

Définition

Espace de noms:: System.Web.UI.Adapters

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

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: Object

ControlAdapter
PageAdapter

Exemples

L’exemple de code suivant montre comment dériver une classe nommée CustomPageAdapter à partir de la PageAdapter classe et remplacer la RenderBeginHyperlink méthode. La RenderBeginHyperlink méthode ajoute un attribut nommé src à un lien hypertexte, qui contient une référence à la page active. Tous les liens hypertexte rendus dans les pages auxquelles CustomPageAdapter il est attaché auront l’attribut 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

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). Une grande partie de l’adaptabilité dans le comportement de rendu peut être encapsulée dans les classes d’enregistreur de texte spécialisées qui dérivent de la HtmlTextWriter classe, de sorte qu’il n’est pas toujours nécessaire de fournir un adaptateur de page.

La plupart des membres des adaptateurs de page dérivés sont appelés à partir de la Page classe ou des adaptateurs de contrôle. Tout d’abord, les Page 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 la fonctionnalité si l’adaptateur de page n’est pas présent.

Les membres de la PageAdapter classe fournissent les fonctionnalités suivantes :

Les CacheVaryByHeaders propriétés et CacheVaryByParams les en-têtes HTTP supplémentaires définissent des en-têtes HTTP GET et POST des paramètres qui peuvent être utilisés pour varier la mise en cache. Elles sont appelées lors de l’initialisation du cache à partir de la Page classe.
La GetStatePersister méthode retourne un objet qui peut être utilisé pour conserver l’affichage combiné et les états de contrôle de la page. Il est référencé à partir de la PageStatePersister propriété si un adaptateur de page dérivé est présent.
La GetPostBackFormReference méthode fournit un fragment de code DHTML qui peut être utilisé pour référencer des formulaires dans des scripts.
La DeterminePostBackMode méthode retourne une collection des variables de publication si la page est en postback. Elle est appelée par le .NET Framework au lieu de la Page.DeterminePostBackMode méthode si un adaptateur de page dérivé est présent.
Les RenderBeginHyperlink méthodes et RenderEndHyperlink les méthodes sont utilisées par les adaptateurs de contrôle pour afficher les liens hypertexte si une carte de page dérivée est présente.
La RenderPostBackEvent méthode affiche un lien hypertexte ou une balise client de publication qui peut envoyer le formulaire.
Les RegisterRadioButton méthodes et GetRadioButtonsByGroup les méthodes sont utilisées par les adaptateurs de contrôle de case d’option pour référencer les autres RadioButton contrôles dans un groupe de cases d’option.
La ClientState propriété permet d’accéder aux états combinés de contrôle et d’affichage de l’objet Page via la propriété interne ClientState de la Page classe.
La TransformText méthode est utilisée par les adaptateurs de contrôle pour effectuer une transformation de texte spécifique à l’appareil.

Constructeurs

PageAdapter()

Initialise une nouvelle instance de la classe PageAdapter.

Propriétés

Browser	Reçoit une référence aux fonctionnalités de navigation du client effectuant la demande HTTP en cours. (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é.
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é.
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é.
Control	Reçoit une référence au contrôle auquel cet adaptateur de contrôles est joint. (Hérité de ControlAdapter)
Page	Reçoit une référence à la page sur laquelle réside le contrôle associé à cet adaptateur. (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é. (Hérité de ControlAdapter)

Méthodes

BeginRender(HtmlTextWriter)	Appelé avant le rendu d'un contrôle. 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. (Hérité de ControlAdapter)
CreateChildControls()	Crée les contrôles enfants spécifiques à la cible pour un contrôle composite. (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.
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.
EndRender(HtmlTextWriter)	Appelé après le rendu d'un contrôle. 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. (Hérité de ControlAdapter)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (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.
GetRadioButtonsByGroup(String)	Récupère une collection de contrôles de case d'option spécifiée par `groupName`.
GetStatePersister()	Retourne un objet qui est utilisé par la page Web pour maintenir les états de contrôle et d'affichage.
GetType()	Obtient le Type de l'instance actuelle. (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. (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. (Hérité de ControlAdapter)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnInit(EventArgs)	Substitue la méthode OnInit(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
OnLoad(EventArgs)	Substitue la méthode OnLoad(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
OnPreRender(EventArgs)	Substitue la méthode OnPreRender(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
OnUnload(EventArgs)	Substitue la méthode OnUnload(EventArgs) au contrôle associé. (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é.
Render(HtmlTextWriter)	Génère le balisage spécifique à la cible pour le contrôle auquel l’adaptateur de contrôle est attaché. (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.
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.
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. (Hérité de ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)	Restitue une balise de fermeture de lien hypertexte au flux de réponse.
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.
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.
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.
SaveAdapterControlState()	Enregistre les informations sur l'état de contrôle pour l'adaptateur de contrôles. (Hérité de ControlAdapter)
SaveAdapterViewState()	Enregistre les informations sur l'état d'affichage pour l'adaptateur de contrôles. (Hérité de ControlAdapter)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TransformText(String)	Transforme le texte pour le navigateur cible.

S’applique à

Voir aussi

ControlAdapter