WebControlAdapter Classe

Définition

Espace de noms:

System.Web.UI.WebControls.Adapters

Assembly:

System.Web.dll

Personnalise le rendu du contrôle Web auquel l’adaptateur de contrôle est attaché, afin de modifier le balisage ou le comportement par défaut pour des navigateurs spécifiques.

public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapter

public class WebControlAdapter : System.Web.UI.Adapters.ControlAdapter

type WebControlAdapter = class
    inherit ControlAdapter

Public Class WebControlAdapter
Inherits ControlAdapter

Héritage

Object

ControlAdapter

WebControlAdapter

Dérivé

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Remarques

La WebControl classe est la classe de base à partir de laquelle les contrôles Web héritent. Il définit de nombreuses propriétés communes à tous les contrôles Web. Pour plus d’informations, consultez WebControl.

Un WebControlAdapter objet est un composant qui remplace certaines WebControl méthodes et événements de classe ou hérités dans son cycle de vie d’exécution pour permettre la gestion spécifique au navigateur ou au balisage. .NET Framework mappe un seul adaptateur de contrôle à un objet dérivé WebControl pour chaque requête cliente.

Un adaptateur modifie un comportement de contrôle pour un navigateur ou une classe spécifique de navigateurs ou agit comme un filtre arbitraire sur une fonctionnalité. Une grande partie de l’adaptabilité dans le comportement de rendu peut être encapsulée dans les classes spécialisées qui dérivent de la HtmlTextWriter classe. Par conséquent, il est probable qu’un seul adaptateur puisse être utilisé pour un certain nombre de comportements de classe de navigateur ou que l’inclusion de l’adaptabilité dans les HtmlTextWriter classes peut utiliser un adaptateur de contrôle inutile.

Les contrôles eux-mêmes ne nécessitent pas nécessairement d’adaptateur. Si les contrôles sont étendus par composition, les adaptateurs pour les contrôles enfants sont généralement suffisants.

Chaque contrôle a des mappages explicites aux adaptateurs via les fichiers de définition .browser. Ainsi, tout accès à la Adapter propriété d’utilisation de WebControl l’objet HttpBrowserCapabilities extrait des fichiers de définition .browser pour effectuer la recherche du mappage de l’adaptateur à contrôler.

Pendant le traitement, .NET Framework intercepte les appels aux méthodes substituables d’un contrôle pouvant être spécifique à la cible. Si un adaptateur de contrôle est attaché, .NET Framework appelle les méthodes d’adaptateur associées. Pour plus d’informations, consultez ControlAdapter.

Le rendu d’une WebControl balise de début et de fin se compose généralement d’une balise de début et de fin, ainsi que d’un balisage interne entre les balises de début et de fin. Les balises sont définies lors de la création de l’objet WebControl . Pour plus d’informations, consultez WebControl.

Les balises sont générées par les méthodes et RenderEndTag les RenderBeginTag méthodes, respectivement. Le balisage interne est généré par la RenderContents méthode.

La Render méthode génère tous les balisages, en appelant des méthodes dans l’ordre suivant :

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

La IsEnabled propriété retourne true uniquement si les WebControl contrôles parent et tous les contrôles parents sont activés. La Control propriété retourne une référence fortement typée à l’objet WebControl.

Constructeurs

Nom	Description
WebControlAdapter()	Initialise une nouvelle instance de la classe WebControlAdapter.

Propriétés

Nom	Description
Browser	Obtient une référence aux fonctionnalités du navigateur du client qui effectuent la requête HTTP actuelle. (Hérité de ControlAdapter)
Control	Obtient une référence au contrôle Web auquel cet adaptateur de contrôle est attaché.
IsEnabled	Obtient une valeur indiquant si le contrôle Web et tous ses contrôles parents sont activés.
Page	Obtient une référence à la page où réside le contrôle associé à cet adaptateur. (Hérité de ControlAdapter)
PageAdapter	Obtient une référence à l’adaptateur de page de la page où réside le contrôle associé. (Hérité de ControlAdapter)

Méthodes

Nom	Description
BeginRender(HtmlTextWriter)	Appelé avant le rendu d’un contrôle. Dans une classe d’adaptateur dérivée, génère des balises ouvrantes requises par une cible spécifique, mais qui ne sont pas nécessaires 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)
EndRender(HtmlTextWriter)	Appelé après le rendu d’un contrôle. Dans une classe d’adaptateur dérivée, génère des balises fermante requises par une cible spécifique, mais qui ne sont pas nécessaires 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()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadAdapterControlState(Object)	Charge les informations d’état du contrôle de l’adaptateur enregistrées SaveAdapterControlState() lors d’une demande précédente sur la page où réside le contrôle associé à cet adaptateur de contrôle. (Hérité de ControlAdapter)
LoadAdapterViewState(Object)	Charge les informations d’état d’affichage de l’adaptateur enregistrées SaveAdapterViewState() lors d’une demande précédente sur la page où réside le contrôle associé à cet adaptateur de contrôle. (Hérité de ControlAdapter)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnInit(EventArgs)	Remplace la OnInit(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnLoad(EventArgs)	Remplace la OnLoad(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnPreRender(EventArgs)	Remplace la OnPreRender(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnUnload(EventArgs)	Remplace la OnUnload(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
Render(HtmlTextWriter)	Génère le balisage spécifique à la cible pour le contrôle auquel l’adaptateur de contrôle est attaché.
RenderBeginTag(HtmlTextWriter)	Crée la balise de début du contrôle Web dans le balisage transmis au navigateur cible.
RenderChildren(HtmlTextWriter)	Génère le balisage spécifique à la cible pour les contrôles enfants dans un contrôle composite auquel l’adaptateur de contrôle est attaché. (Hérité de ControlAdapter)
RenderContents(HtmlTextWriter)	Génère le balisage interne spécifique à la cible pour le contrôle Web auquel l’adaptateur de contrôle est attaché.
RenderEndTag(HtmlTextWriter)	Crée la balise de fin du contrôle Web dans le balisage transmis au navigateur cible.
SaveAdapterControlState()	Enregistre les informations d’état du contrôle pour l’adaptateur de contrôle. (Hérité de ControlAdapter)
SaveAdapterViewState()	Enregistre les informations d’état d’affichage de l’adaptateur de contrôle. (Hérité de ControlAdapter)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• ControlAdapter
• WebControl
• Control