Services WPSC
Dernière modification : vendredi 30 mai 2008
S’applique à : SharePoint Foundation 2010
Dans cet article
Service de découverte des composants WebPart
Service de notification des composants WebPart
Service de gestion d'état
Les fonctionnalités de WPSC (Web Part Page Services Component) sont organisées en services. Il existe plusieurs services, chacun d'eux définissant une étendue de la fonctionnalité qui cible un but bien précis. Par exemple, le service de découverte des composants WebPart permet à des composants WebPart dérivés de la classe Microsoft.SharePoint.WebPartPages.WebPart de détecter d'autres composants WebPart au moment de l'exécution. Le service de notification des composants WebPart envoie et reçoit des informations sur les événements qui ont lieu dans les différents composants WebPart ou sur une page de composants WebPart. Un service WPSC est bien une création de sémantique ; il n'existe aucun aspect binaire dans un service spécifique.
Un seul fichier Microsoft JScript (IE50UP.JS ou IE55UP.JS) contient les fonctionnalités de tous les services WPSC. En soi, un service est simplement un moyen d'identifier un ensemble d'objets, de collections, de méthodes et de propriétés à utiliser pour atteindre un objectif précis. N'importe quel objet donné peut jouer un rôle dans plusieurs services. Aucun objet ou aucune collection n'est limitée à un service spécifique, et aucun objet ou aucune collection n'encapsule un service.
Voici une description des services fournis par WPSC : Découverte, Notification et Gestion d'état.
Service de découverte des composants WebPart
Ce service offre un moyen pour les composants WebPart de déterminer la présence d'autres composants WebPart au moment de l'exécution, ce qui permet de créer des dépendances entre les composants WebPart ou de modifier de manière dynamique un composant WebPart en fonction de l'état d'un autre composant WebPart.
Le service de découverte des composants WebPart détecte si d'autres composants WebPart sont présents dans la zone Collection des composants WebPart de la page de composants WebPart. Une fois que vous avez déterminé qu'un composant WebPart était disponible, vous pouvez vérifier son état et utiliser les résultats pour définir comment un composant WebPart ou une page de composants WebPart doit répondre.
Le service de découverte des composants WebPart permet le scénario suivant : admettons que vous vouliez rendre un composant WebPart Commande dépendant d'un composant WebPart Client, de sorte que le composant Commande s'affiche uniquement lorsque le composant Client est disponible. En énumérant la collection des composants WebPart, vous pouvez déterminer si les deux composants se trouvent sur la page. Vous pouvez ensuite vérifier leur état afin de déterminer un plan d'action complémentaire. Par exemple, si le composant Commande est en lecture/écriture, le composant Client l'est aussi. Pour utiliser le service de découverte des composants WebPart, vous utilisez l'objet WPSC, l'objet WebPartPage, la collection des composants WebPart et un ou plusieurs objets de composants WebPart.
Service de notification des composants WebPart
Ce service fournit pour les composants WebPart un mécanisme standard de multidiffusion d'événements qui masque la complexité des mécanismes d'événements sous-jacents du navigateur Web, tels que les événements DHTML. Grâce à lui, des composants WebPart peuvent s'inscrire à un événement et fournir une fonction qui est appelée lors de l'exécution de l'événement inscrit. Les événements ont lieu si un objet change d'état. Ces objets peuvent être des objets système (autrement dit, des objets statiques portant un nom fixe, tels que l'objet WebPartPage ou la collection de composants WebPart), ou bien des objets personnalisés que vous définissez (par exemple, Clients ou Contacts).
L'étendue d'un événement est un espace de noms qui définit un contexte pour l'événement. Un composant WebPart peut déclencher un événement ou y répondre. La séparation de ces deux rôles permet la coordination des composants WebPart sur une page. Les événements système et les événements personnalisés sont gérés de la même manière, ce qui signifie que les scripts peuvent être plus simples et les composants WebPart mieux encapsulés. L'étendue permet également de surfacer des événements de session à partir du navigateur ou du système d'exploitation.
Service de gestion d'état
Ce service offre la possibilité d'accéder aux propriétés intégrées et personnalisées d'un composant WebPart à partir du client au moment de l'exécution et de les modifier. L'état d'un composant WebPart est la combinaison des propriétés des composants WebPart standard et de toutes les extensions définies par l'utilisateur ou par le système. Par exemple, un composant WebPart qui affiche un code de cotation doit pouvoir enregistrer et récupérer des informations de personnalisation entre les sessions. Dans ce cas, les symboles boursiers que l'utilisateur sélectionne sont des données privées. Ces données et les valeurs provenant du schéma de composants WebPart que vous spécifiez constituent l'état du composant WebPart.
Le service de gestion d'état traite les informations d'état pour un composant WebPart particulier. Tous les accès à une page de composants WebPart et à des composants WebPart via la collection de composants WebPart récupèrent des informations d'état basées sur la vue actuelle de la page. Si vous êtes en mode personnel, des informations personnalisées sont extraites ; si vous êtes en mode partagé, des informations globales sont extraites. Il est important de noter que les informations d'état, personnalisées ou globales, sont stockées avec le composant WebPart. Si vous supprimez un composant WebPart, ses informations d'état sont perdues.
Voir aussi
Concepts
Programmation côté client avec le WPSC
Prise en charge des événements système standard