ControlAdapter Classe

Définition

public ref class ControlAdapter abstract

public abstract class ControlAdapter

type ControlAdapter = class

Public MustInherit Class ControlAdapter

Héritage

Object

ControlAdapter

Dérivé

System.Web.UI.Adapters.PageAdapter

System.Web.UI.WebControls.Adapters.WebControlAdapter

Remarques

Les adaptateurs de contrôle sont des composants qui remplacent certaines Control méthodes et événements de classe dans son cycle de vie d’exécution pour autoriser la gestion spécifique au navigateur ou au balisage. Le .NET Framework mappe un seul adaptateur de contrôle dérivé à un Control objet pour chaque requête cliente.

Un adaptateur modifie un contrôle pour un navigateur ou une classe de navigateurs spécifique ou agit comme un filtre arbitraire sur une fonctionnalité. En règle générale, l’adaptateur est défini par le langage de balisage utilisé par le navigateur (par exemple, XHTML ou HTML 3.2). 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 pourrait rendre l’utilisation d’un adaptateur de contrôle inutile.

Un adaptateur pour une classe de contrôle s’applique à tous les contrôles qui héritent de cette classe, sauf si des adaptateurs plus spécialisés sont présents. Par exemple, un adaptateur pour la BaseValidator classe peut être utilisé pour tous les Validator objets.

Les adaptateurs n’héritent généralement pas directement de la ControlAdapter classe, mais de l’une des classes de base d’adaptateurs spécifiques à la cible qui fournissent des fonctionnalités supplémentaires spécifiques au type de contrôle et au navigateur cible ou au rendu particulier requis.

Les contrôles eux-mêmes ne nécessitent pas nécessairement d’adaptateur. Si les contrôles sont étendus par composition, les adaptateurs de contrôle 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 Control.Adapter propriété utilise l’objet HttpBrowserCapabilities extrait des fichiers de définition de navigateur pour effectuer la recherche du mappage de l’adaptateur à contrôler.

Au cours du traitement, le .NET Framework intercepte les appels aux méthodes substituables d’un contrôle qui peut être spécifique à la cible. Si un adaptateur de contrôle est attaché, le .NET Framework appelle les méthodes d’adaptateur associées.

L’adaptateur effectue le rendu du contrôle via la Render méthode. En cas de substitution, Render il est potentiellement impossible d’appeler l’implémentation de la classe de base, car elle effectue un rappel sur la Control.Render méthode. Cela peut entraîner le rendu deux fois, une fois par l’adaptateur et une fois par le contrôle.

La Render méthode de base revient sur la Control.Render méthode du contrôle. Par conséquent, si vous remplacez Render, vous ne devez pas appeler l’implémentation de classe de base, sauf si le rendu que vous implémentez est en plus de celui fourni par Control.Render le contrôle.

Vous devez vous assurer que le .NET Framework effectue une interception pour les adaptateurs des contrôles enfants. Pour ce faire, appelez la RenderChildren méthode de base, qui appelle la Control.RenderChildren méthode du contrôle, à partir de votre Render remplacement.

Les méthodes et EndRender les BeginRender méthodes sont appelées par le contrôle immédiatement avant et après (respectivement) le contrôle appelle la Render méthode. Si les tâches de traitement préalables et post-rendu sont les seules tâches de traitement spécifiques au navigateur requises, l’utilisation BeginRender et EndRender peut rendre inutile de remplacer Render. Le comportement par défaut des BeginRender méthodes et EndRender des méthodes consiste à appeler les méthodes correspondantes du HtmlTextWriter.

Pour conserver ses propres informations d’état, un adaptateur de contrôle peut remplacer les méthodes, SaveAdapterViewStateet LoadAdapterViewState les SaveAdapterControlStateLoadAdapterControlStateméthodes. SaveAdapterControlState, SaveAdapterViewState, et LoadAdapterControlStateLoadAdapterViewState sont appelés lorsque le contrôle privé et les états d’affichage sont enregistrés et chargés, respectivement.

Les OnInitméthodes , , et OnUnload OnLoadOnPreRenderde base rappellent les méthodes de classe correspondantes.Control Ainsi, l’une de ces ControlAdapter méthodes remplacées doit appeler ses méthodes de base ; sinon, l’événement associé à la Control méthode de classe ne sera pas déclenché.

Les contrôles et les adaptateurs implémentent éventuellement les interfaces et IPostBackEventHandler les IPostBackDataHandler contrôles. Le .NET Framework détermine si un adaptateur existe et si l’adaptateur implémente ces interfaces. Si c’est le cas, l’adaptateur doit remplacer le , RaisePostDataChangedEventet RaisePostBackEvent les LoadPostDataméthodes, si nécessaire. Si les données de publication ne sont pas reconnues dans l’adaptateur, elles doivent rappeler le contrôle pour le traiter. Les gestionnaires d’événements suivants doivent également rappeler le contrôle.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de la ControlAdapter classe, un contrôle qui nécessite des fonctionnalités d’adaptateur générales doit avoir une classe de base d’adaptateur correspondante, nommée dans le modèle ControlTypeAdapter (par exemple). TextBoxAdapter L’adaptateur doit au minimum retourner une instance fortement typée du contrôle par le biais de sa Control propriété.

1. Les adaptateurs de contrôle pour un type de contrôle et un langage de balisage donnés doivent être nommés dans le modèle MarkupControlTypeAdapter (par exemple). XhtmlTextBoxAdapter Les adaptateurs d’un contrôle doivent être implémentés dans un Adapters sous-espace.

Les adaptateurs de contrôle doivent hériter de la classe de base appropriée et suivre le même modèle d’héritage que le contrôle. Par exemple, un adaptateur pour un contrôle qui hérite de la Control classe de base doit hériter de la classe ou de la ControlAdapter classe appropriée ControlTypeAdapter .

Tous les adaptateurs spécialisés doivent être définis pour le contrôle spécialisé sous tous les nœuds d’appareil dans les fichiers .browser de configuration.

Un contrôle correctement implémenté ne doit pas supposer qu’un adaptateur est attaché ou que l’adaptateur attaché implémente une interface spécifique. Au lieu de cela, il doit vérifier ces éléments avant d’appeler.

Il est possible de simuler la substitution de méthodes d’événement protégées dans le contrôle, telles que la OnClick(EventArgs) méthode du LinkButton. Tout d’abord, créez une classe d’adaptateur avec une méthode OnClick . Créez ensuite un contrôle dérivé de LinkButton la méthode et remplacez la OnClick(EventArgs) méthode. La méthode remplacée OnClick(EventArgs) appelle la méthode OnClick de l’adaptateur. L’objet adaptateur est disponible via la propriété protégée Adapter de la Control classe. La Adapter propriété du contrôle est null lorsqu’il n’y a pas d’adaptateur associé. Tout code doit donc vérifier cette condition avant d’appeler les méthodes de l’adaptateur.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• Control