XhtmlControlAdapter 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.
Attention
The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.
Fournit un adaptateur de contrôle par défaut pour le rendu des contrôles mobiles dans le balisage XHTML. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET.
public ref class XhtmlControlAdapter : System::Web::UI::MobileControls::Adapters::ControlAdapter
public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter
[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter
type XhtmlControlAdapter = class
inherit ControlAdapter
[<System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>]
type XhtmlControlAdapter = class
inherit ControlAdapter
Public Class XhtmlControlAdapter
Inherits ControlAdapter
- Héritage
- Dérivé
- Attributs
Remarques
Cette classe fournit un adaptateur de contrôle mobile de base qui restitue un contrôle et chacun de ses enfants dans le balisage XHTML pour les appareils mobiles. Il fournit également des méthodes d’assistance et des propriétés communes pour les adaptateurs de contrôle mobiles XHTML dérivés.
Les adaptateurs de contrôle sont des composants qui remplacent certaines Control méthodes et événements de classe pour autoriser la gestion spécifique au navigateur ou au balisage. Une grande partie de l’adaptabilité dans le comportement de rendu est encapsulée dans la XhtmlTextWriter classe. Si vous envisagez de créer votre propre adaptateur de contrôle, gardez à l’esprit qu’un seul adaptateur peut être utilisé pour remplacer un certain nombre de comportements de classe de navigateur. Sinon, en incluant l’adaptabilité souhaitée dans une classe dérivée de la XhtmlMobileTextWriter classe, vous pouvez éliminer la nécessité d’utiliser un adaptateur de contrôle.
Un adaptateur pour une classe de contrôle spécifique 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, la XhtmlValidatorAdapter classe est utilisée pour valider tous les contrôles mobiles pour les appareils qui nécessitent ou peuvent afficher le balisage XHTML.
Pendant le traitement, .NET Framework intercepte les appels aux méthodes d’un contrôle spécifique à la cible actuelle. Si un adaptateur de contrôle est associé au contrôle, le .NET Framework appelle les méthodes d’adaptateur associées.
Certaines propriétés d’un contrôle régissent la façon dont il s’affiche sur plusieurs pages secondaires pour un appareil mobile. Ces pages sont collectivement appelées interface utilisateur secondaire. La SecondaryUIMode propriété peut être utilisée pour définir la page à afficher. La ExitSecondaryUIMode méthode peut être utilisée pour supprimer tous les paramètres d’interface utilisateur secondaire.
Notes pour les héritiers
Lorsque vous héritez de la XhtmlControlAdapter classe, nommez votre adaptateur pour un type de contrôle et un langage de balisage donnés dans le modèle MarkupControlTypeAdapter (par exemple, XhtmlTextBoxAdapter). Les adaptateurs d’un contrôle qui fournit le balisage XHTML doivent être implémentés dans l’espace System.Web.UI.MobileControls.Adapters.XhtmlAdapters de noms.
Tous les adaptateurs spécialisés doivent être définis pour le contrôle spécialisé sous chacun des 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 conditions.
Un certain nombre de méthodes de rendu conditionnel permettent des conditions telles que l’interface utilisateur secondaire et les appareils d’affichage qui nécessitent des sauts de ligne après chaque bloc ou après chaque contrôle inline. Les exemples de ces méthodes conditionnelles sont ConditionalSetPendingBreak(XhtmlMobileTextWriter) et ConditionalEnterLayout(XhtmlMobileTextWriter, Style). Ces méthodes fonctionnent pour un appareil donné, quel que soit le contrôle affiché. Il est peu probable que vous deviez remplacer ces méthodes lors de la création d’un adaptateur de contrôle basé sur cette classe. Au minimum, vous devez remplacer les Render méthodes.
Le filtrage des appareils est nécessaire pour utiliser un adaptateur spécifique pour un contrôle serveur. Pour plus d’informations sur le filtrage des appareils, consultez Vue d’ensemble architecturale du comportement du contrôle adaptatif et vue d’ensemble du filtrage des appareils.
Constructeurs
| Nom | Description |
|---|---|
| XhtmlControlAdapter() |
Obsolète.
Crée une instance de la XhtmlControlAdapter classe. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
Champs
| Nom | Description |
|---|---|
| NotSecondaryUI |
Obsolète.
Valeur retournée par la SecondaryUIMode propriété, indiquant que l’adaptateur n’est pas actuellement en mode d’interface utilisateur secondaire. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
Propriétés
| Nom | Description |
|---|---|
| Control |
Obsolète.
Retourne une référence fortement typée au contrôle associé. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| CssLocation |
Obsolète.
Indique si la feuille de style se trouve sous la forme d’un fichier physique externe, est interne à la page active, est stockée dans l’état de session actuel ou est stockée dans le cache de l’application. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| Device |
Obsolète.
Retourne l’objet de fonctionnalités de l’appareil associé à la requête. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| DocumentType |
Obsolète.
Indique le type de balisage XHTML utilisé pour afficher le document actif. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ItemWeight |
Obsolète.
Accède au poids approximatif d’un élément unique dans le contrôle. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| Page |
Obsolète.
Retourne la page associée à l’adaptateur d’appareil. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| PageAdapter |
Obsolète.
Obtient l’adaptateur de page de la page sur laquelle réside le contrôle associé. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| SecondaryUIMode |
Obsolète.
Obtient le mode d’interface utilisateur secondaire actuel. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| Style |
Obsolète.
Retourne l’objet de style associé au contrôle auquel l’adaptateur d’appareil est attaché. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| StyleSheetLocationAttributeValue |
Obsolète.
Obtient la valeur de l’attribut |
| StyleSheetStorageApplicationSetting |
Obsolète.
Obtient la valeur du paramètre de |
| VisibleWeight |
Obsolète.
Obtient ou définit le poids approximatif du contrôle, en caractères. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
Méthodes
| Nom | Description |
|---|---|
| CalculateOptimumPageWeight(Int32) |
Obsolète.
Détermine le poids de page optimal pour l’appareil. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| ClearPendingBreakIfDeviceBreaksOnBlockLevel(XhtmlMobileTextWriter) |
Obsolète.
Efface un arrêt en attente si l’appareil cible s’arrête sur les éléments de bloc. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalClearCachedEndTag(XhtmlMobileTextWriter, String) |
Obsolète.
Efface la balise de fin actuelle de l’enregistreur de texte donnée si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalClearPendingBreak(XhtmlMobileTextWriter) |
Obsolète.
Efface un saut en attente dans l’appareil cible si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalEnterFormat(XhtmlMobileTextWriter, Style) |
Obsolète.
Commence une section avec la balise d’ouverture et les attributs qui implémentent les formats du style spécifié, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalEnterLayout(XhtmlMobileTextWriter, Style) |
Obsolète.
Commence une section avec la balise d’ouverture et les attributs qui implémentent la disposition du style spécifié, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalEnterStyle(XhtmlMobileTextWriter, Style, String) |
Obsolète.
Écrit la balise d’ouverture de l’élément spécifié, ainsi que les attributs qui implémentent la mise en forme de disposition et de caractère du style spécifié, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalEnterStyle(XhtmlMobileTextWriter, Style) |
Obsolète.
Écrit la balise d’ouverture d’une |
| ConditionalExitFormat(XhtmlMobileTextWriter, Style) |
Obsolète.
Termine un bloc qui utilise la mise en forme de caractères à partir d’un style spécifié, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalExitLayout(XhtmlMobileTextWriter, Style) |
Obsolète.
Termine un bloc qui utilise la mise en forme de disposition à partir d’un style spécifié, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalExitStyle(XhtmlMobileTextWriter, Style) |
Obsolète.
Termine un |
| ConditionalPopPhysicalCssClass(XhtmlMobileTextWriter) |
Obsolète.
Supprime le nom actuel de la classe de feuille de style en cascade de l’objet XhtmlMobileTextWriter , si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalRenderClassAttribute(XhtmlMobileTextWriter) |
Obsolète.
Place un attribut de nom de classe sur l’élément suivant à afficher, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalRenderClosingDivElement(XhtmlMobileTextWriter) |
Obsolète.
Affiche une balise fermante |
| ConditionalRenderClosingSpanElement(XhtmlMobileTextWriter) |
Obsolète.
Affiche un élément fermant |
| ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String, String) |
Obsolète.
Inclut un attribut personnalisé avec le nom et la valeur spécifiés dans l’élément suivant à afficher, si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String) |
Obsolète.
Obtient la valeur de l’attribut avec le nom spécifié à partir du contrôle associé et l’affiche sur l’élément suivant avec le nom spécifié si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalRenderOpeningDivElement(XhtmlMobileTextWriter) |
Obsolète.
Affiche une balise d’ouverture pour un |
| ConditionalRenderOpeningSpanElement(XhtmlMobileTextWriter) |
Obsolète.
Affiche une balise d’ouverture pour un |
| ConditionalSetPendingBreak(XhtmlMobileTextWriter) |
Obsolète.
Définit un arrêt en attente si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ConditionalSetPendingBreakAfterInline(XhtmlMobileTextWriter) |
Obsolète.
Définit un saut en attente après les éléments inline si certaines conditions sont remplies. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| CreateTemplatedUI(Boolean) |
Obsolète.
Appelé par un contrôle pour créer une interface utilisateur avec modèle. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| Equals(Object) |
Obsolète.
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| ExitSecondaryUIMode() |
Obsolète.
Quitte tout mode d’interface utilisateur secondaire pour le contrôle. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| GetCustomAttributeValue(MobileControl, String) |
Obsolète.
Obtient la valeur de l’attribut spécifié à partir d’un contrôle donné. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| GetCustomAttributeValue(String) |
Obsolète.
Obtient la valeur de l’attribut spécifié à partir du balisage du contrôle associé. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| GetDefaultLabel(Int32) |
Obsolète.
Retourne la chaîne par défaut localisée pour le contrôle d’étiquette. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| GetHashCode() |
Obsolète.
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obsolète.
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| HandlePostBackEvent(String) |
Obsolète.
Retourne |
| LoadAdapterState(Object) |
Obsolète.
Charge les données d’état d’affichage spécifiques à cet adaptateur. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| LoadPostData(String, NameValueCollection, Object, Boolean) |
Obsolète.
Retourne |
| MemberwiseClone() |
Obsolète.
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnInit(EventArgs) |
Obsolète.
Appelé après un objet, tel qu’un formulaire ou une page, est initialisé. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| OnLoad(EventArgs) |
Obsolète.
Charge les données relatives à un contrôle, à une page ou à un adaptateur d’appareil. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| OnPreRender(EventArgs) |
Obsolète.
Appelée par la méthode du OnPreRender(EventArgs) contrôle, pour effectuer un travail spécifique à l’adaptateur avant le rendu. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| OnUnload(EventArgs) |
Obsolète.
Décharge les données relatives à un contrôle, à une page ou à une carte d’appareil. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| PreprocessQueryString(String) |
Obsolète.
Obtient la partie de la chaîne de requête donnée qui contient des paramètres pour le traitement de la requête. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| Render(HtmlTextWriter) |
Obsolète.
Affiche le contrôle associé et tous ses contrôles enfants sur le client. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| Render(XhtmlMobileTextWriter) |
Obsolète.
Affiche le contrôle associé et tous ses contrôles enfants sur le client. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderAsHiddenInputField(XhtmlMobileTextWriter) |
Obsolète.
Affiche le texte du champ masqué pour un contrôle. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String, String) |
Obsolète.
Affiche la balise d’ouverture d’un lien à l’aide de l’élément donné et de la cible, ainsi que les styles donnés XhtmlMobileTextWriter ou le nom de classe de feuille de style en cascade donné, la clé d’accès et le texte du titre. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String) |
Obsolète.
Affiche la balise d’ouverture d’un lien à l’aide de l’élément donné et de la cible, ainsi que les styles donnés XhtmlMobileTextWriter ou le nom de classe de feuille de style en cascade donné. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderBeginLink(XhtmlMobileTextWriter, String) |
Obsolète.
Affiche la balise d’ouverture d’un lien à l’aide de l’élément donné XhtmlMobileTextWriter et de la cible. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderChildren(HtmlTextWriter) |
Obsolète.
Affiche les enfants du contrôle. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. (Hérité de ControlAdapter) |
| RenderClosingListTag(XhtmlMobileTextWriter, String) |
Obsolète.
Affiche une balise fermante pour un élément de liste spécifié. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderEndLink(XhtmlMobileTextWriter) |
Obsolète.
Affiche une balise fermante ( |
| RenderOffPageVariables(XhtmlMobileTextWriter, Control, Int32) |
Obsolète.
Affiche les variables de publication masquées pour les contrôles enfants qui ne sont pas visibles en raison de la pagination ou de l’interface utilisateur secondaire. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderOpeningListTag(XhtmlMobileTextWriter, String) |
Obsolète.
Affiche une balise d’ouverture pour le nom de la balise spécifiée. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String, Style, String) |
Obsolète.
Affiche un événement de publication en tant que lien avec l’argument, le texte et la clé d’accès spécifiés, ainsi que les styles spécifiés ou le nom de classe de feuille de style en cascade spécifié. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String) |
Obsolète.
Affiche un événement de publication en tant que lien avec l’argument, le texte et la clé d’accès spécifiés. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String) |
Obsolète.
Affiche un événement de publication sous forme de lien avec l’argument et le texte spécifiés. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| SaveAdapterState() |
Obsolète.
Enregistre les données d’état d’affichage spécifiques à cet adaptateur. Cette API est obsolète. Pour plus d’informations sur le développement d’applications mobiles ASP.NET, consultez Mobile Apps & Sites avec ASP.NET. |
| ToString() |
Obsolète.
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |