WebControlAdapter Classe
Définition
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.
Personnalise le rendu pour le contrôle Web auquel l'adaptateur de contrôles 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::ControlAdapterpublic class WebControlAdapter : System.Web.UI.Adapters.ControlAdaptertype WebControlAdapter = class
inherit ControlAdapterPublic Class WebControlAdapter
Inherits ControlAdapter- Héritage
- Dérivé
Remarques
La WebControl classe est la classe de base dont héritent les contrôles Web. 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 certains é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. le .NET Framework mappe un adaptateur de contrôle unique à un WebControl objet dérivé pour chaque demande du client.
Un adaptateur modifie le comportement d’un contrôle pour un navigateur ou une classe de navigateurs spécifiques ou agit comme un filtre arbitraire sur certaines fonctionnalités. Une grande partie de l’adaptabilité du 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 plusieurs comportements de classe de navigateur ou que l’inclusion de l’adaptabilité dans les HtmlTextWriter classes peut rendre superflue l’utilisation d’un adaptateur de contrôle.
Les contrôles eux-mêmes ne nécessitent pas nécessairement un 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 de navigateur. Ainsi, tout accès à la Adapter propriété de WebControl utilise l' HttpBrowserCapabilities objet extrait des fichiers de définition. Browser pour effectuer la recherche du mappage de l’adaptateur à contrôler.
lors 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. Pour plus d'informations, consultez ControlAdapter.
Le rendu d’un WebControl est généralement constitué 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 WebControl création de. Pour plus d'informations, consultez WebControl.
Les balises sont générées par les RenderBeginTag RenderEndTag méthodes et, respectivement. Le balisage interne est généré par la RenderContents méthode.
La Render méthode génère tout le balisage en appelant des méthodes dans l’ordre suivant :
La IsEnabled propriété retourne true uniquement si le WebControl et tous ses contrôles parents sont activés. La Control propriété retourne une référence fortement typée à WebControl .
Constructeurs
| WebControlAdapter() |
Initialise une nouvelle instance de la classe WebControlAdapter. |
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) |
| Control |
Obtient une référence au contrôle Web auquel cet adaptateur de contrôles est attaché. |
| IsEnabled |
Obtient une valeur indiquant si le contrôle Web et tous ses contrôles parents sont activés. |
| 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) |
| 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) |
| 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) |
| 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 pour le contrôle Web dans le balisage transmis au navigateur cible. |
| 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) |
| RenderContents(HtmlTextWriter) |
Génère le balisage interne spécifique à la cible pour le contrôle Web auquel l'adaptateur de contrôles est attaché. |
| RenderEndTag(HtmlTextWriter) |
Crée la balise de fin pour le contrôle Web dans le balisage transmis au navigateur cible. |
| 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) |