Adaptateurs et pages de composants WebPart mobiles
Dernière modification : mercredi 2 février 2011
S’applique à : SharePoint Foundation 2010
Cette rubrique offre une vue d’ensemble de l’infrastructure d’adaptateurs SharePoint Foundation pour le rendu des composants WebPart sur les appareils mobiles.
Adaptation mobile dans SharePoint Foundation
Les développeurs peuvent rendre les pages de composants WebPart sur les sites Web SharePoint Foundation accessibles aux appareils mobiles en utilisant une variante du système d’adaptateurs mobiles de Microsoft ASP.NET 3.5. Le système d’adaptation mobile dans SharePoint Foundation est fondamentalement le même :
Lorsqu’une page de composants WebPart est demandée, le serveur Web frontal détecte, d’après l’en-tête de la demande, le type d’appareil qui effectue la demande.
Si un appareil mobile effectue la demande, ASP.NET recherche chaque composant WebPart de la page demandée dans le fichier compat.browser pour déterminer l’adaptateur mobile qui lui est éventuellement associé.
Pour chacun des événements, Init, Load, PreRender et UnLoad(), si un composant WebPart possède un adaptateur mobile, le gestionnaire de l’adaptateur pour l’événement est appelé plutôt que le gestionnaire du composant WebPart, bien que généralement le gestionnaire de l’adaptateur appelle le gestionnaire du composant WebPart dans le cadre de sa logique.
L’implémentation, dans SharePoint Foundation, des gestionnaires de l’adaptateur pour les quatre événements vérifie si la page actuelle est un objet WebPartMobilePage. Si tel est le cas, le runtime appelle la méthode On*ForMobile correspondante : OnLoadForMobile(EventArgs), OnInitForMobile(EventArgs), OnPreRenderForMobile(EventArgs) ou OnUnloadForMobile(EventArgs).
Pour plus d’informations sur le système d’adaptation mobile Microsoft ASP.NET 3.5, voir Architectural Overview of Adaptive Control Behavior, Browser Definition File Schema (browsers Element) et System.Web.UI.Adapters.ControlAdapter.
Programmation de SharePoint Foundation Mobile Adaption Framework
Développer sur l’infrastructure SharePoint Foundation pour les adaptateurs mobiles est plus simple que de développer sur le système d’adaptation mobile Microsoft ASP.NET 3.5. Tout comme le système Microsoft ASP.NET 3.5, vous créez un contrôle d’adaptateur mobile pour chaque composant WebPart que vous souhaitez rendre accessible aux appareils mobiles et vous mappez cet adaptateur au composant WebPart dont il adapte le rendu dans le fichier compat.browser.
Il existe toutefois des différences entre le développement avec l’infrastructure SharePoint Foundation et le développement d’adaptateurs mobiles avec Microsoft ASP.NET 3.5. La plupart de ces différences sont nécessaires pour assurer la conformité au modèle de sécurité de SharePoint Foundation:
Votre classe d’adaptateur dérive de Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter au lieu de dériver directement de System.Web.UI.Adapters.ControlAdapter.
Votre classe d’adaptateur doit être inscrite en tant que contrôle sécurisé. Pour plus d’informations sur cette procédure, voir Utiliser des fichiers Web.config.
Vous ne devez pas substituer la méthode Render(HtmlTextWriter) héritée de ControlAdapter. En revanche, vous devez substituer l’une des méthodes CreateControlsForSummaryView() et CreateControlsForDetailView() ou les deux.
Vous ne devez pas substituer les méthodes OnLoad(EventArgs), OnInit(EventArgs), OnPreRender(EventArgs) et OnUnload(EventArgs) que Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter hérite de ControlAdapter. En revanche, si vous devez ajouter une logique supplémentaire pour l’un de ces événements, vous devez substituer une ou plusieurs méthodes de remplacement sécurisées spéciales à SharePoint : Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter: OnLoadForMobile(EventArgs), OnInitForMobile(EventArgs), OnPreRenderForMobile(EventArgs) et OnUnloadForMobile(EventArgs).
Important
Pour obtenir des informations importantes sur la substitution de ces méthodes, reportez-vous aux rubriques de référence de ces quatre méthodes.
Les pages des composants WebPart accessibles aux appareils mobiles sont des objets de la classeWebPartMobilePage ; toutefois, vous ne les créez pas. Lorsqu’un utilisateur d’appareil mobile accède à une page de composants WebPart contenant des composants WebPart adaptés, un objet WebPartMobilePage est créé par le runtime et retourné à l’appareil mobile.
Chaque page de composants WebPart, qui contient des composants WebPart adaptés pour les appareils mobiles, possède une page d’application correspondante qui permet de définir la visibilité et l’ordre des composants WebPart adaptés. Comme ces pages sont des objets du type WebPartMobileSettingPage et qu’elles sont également créées au moment de l’exécution lorsqu’un utilisateur accède à l’une d’elles (généralement en cliquant sur un bouton du Ruban d’une page de composants WebPart), vous ne créez pas ces objets non plus.
Voir aussi
Référence
System.Web.UI.Adapters.ControlAdapter
Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter
Concepts
Utiliser des fichiers Web.config