Vue d’ensemble : utiliser le modèle objet pour personnaliser l’administration
Dernière modification : mercredi 7 avril 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Gérer les paramètres d’administration
Définir les paramètres d’administration personnalisés
Sérialisation automatique
Dans cette section
Vous pouvez utiliser l’espace de noms Microsoft.SharePoint.Administration pour résoudre deux scénarios clés de personnalisation de l’administration d’un déploiement de SharePoint Foundation : gestion des paramètres de propriété d’administration et création d’objets pour les propriétés personnalisées. Vous pouvez utiliser des types et des membres existants pour apporter des changements globaux aux paramètres utilisés en mode natif dans SharePoint Foundation, mais lors de la génération d’une application sur la plateforme, vous pouvez créer des classes personnalisées qui définissent et stockent des paramètres de propriétés personnalisées.
Gérer les paramètres d’administration
SharePoint Foundation comprend un modèle objet d’administration actualisé qui permet d’accéder aux fonctionnalités qui étaient masquées dans les versions précédentes. Le nouveau modèle objet est conçu de façon à ce que vous puissiez facilement modifier les paramètres d’administration dans un déploiement. Si vous disposez d’une batterie de serveurs volumineuse ou de nombreuses batteries de serveurs et que vous devez modifier globalement un paramètre d’administration, vous pouvez effectuer cette opération par le biais du modèle objet.
Au moyen de quelques lignes de code, vous pouvez écrire un script ou une application console de base qui configure une batterie de serveurs entière de manière particulière. Pour modifier un paramètre de propriété spécifique, utilisez le modèle objet. Pour une tâche qui illustre la création d’une application console simple en vue de gérer un paramètre SharePoint Foundation, voir Procédure : ajouter des types de fichiers bloqués.
Définir les paramètres d’administration personnalisés
Lorsque vous générez une application sur la plateforme SharePoint Foundation, vous devrez peut-être créer une classe pour définir les paramètres de propriétés personnalisés de votre application et faciliter leur stockage. L’espace de noms Microsoft.SharePoint.Administration dans SharePoint Foundation introduit la persistance des objets, grâce à laquelle les classes qui dérivent de la classe SPPersistedObject de base sont conservées dans la base de données SharePoint Foundation. Pour créer un objet persistant, vous créez une classe qui hérite de SPPersistedObject ou d’une classe dans l’espace de noms Microsoft.SharePoint.Administration qui dérive de SPPersistedObject. Votre classe peut définir un modèle objet pour stocker des paramètres de propriétés personnalisés dans la base de données SharePoint Foundation. Vous pouvez créer, par exemple, un service Windows qui utilise SharePoint Foundation d’une certaine façon, ce qui implique la création d’une classe qui hérite de la classe SPWindowsService pour stocker des paramètres spécifiques à votre service Windows. Votre DLL compilée fournit aux clients un modèle objet qui leur permet de récupérer ou d’enregistrer les propriétés. SharePoint Foundation fournit un moyen et un emplacement de stockage de vos paramètres et gère leur disponibilité pour tous les serveurs et processus de la batterie de serveurs, y compris pour l’actualisation du cache.
Pour obtenir un exemple qui montre comment définir un objet d’administration personnalisé, voir Procédure pas à pas : créer un objet de service de contenu.
Sérialisation automatique
Il est inutile d’écrire du code pour la sérialisation, car SharePoint Foundation gère automatiquement la sérialisation des objets persistants, qui, par nature, dérivent de la classe SPAutoSerializingObject. Si vous développez un produit sur la plateforme SharePoint Foundation et que vous avez besoin d’un emplacement pour stocker des paramètres accessibles à tous les serveurs de la batterie de serveurs, la taille de la batterie de serveurs n’a pas d’importance et vous disposez de deux options :
Placez les paramètres dans un fichier texte et, à chaque modification d’un élément, copiez le fichier sur tous les serveurs ou placez le fichier dans un partage auquel tous les serveurs peuvent systématiquement accéder, ou, éventuellement, entrez des paramètres dans le Registre de tous les serveurs. Vous devrez peut-être écrire une grande quantité de code complexe pour chaque propriété et déterminer comment placer le paramètre de propriété à l’emplacement approprié et comment le récupérer.
Créez une classe d’objet persistant et ajoutez des champs arbitraires pour stocker vos paramètres. Étant donné que votre classe est automatiquement sérialisée, il est inutile de déterminer la procédure à suivre pour stocker les données ou les convertir en un format de stockage approprié. Vous fournissez une classe qui contient des champs pour des entiers, des chaînes, des GUID, des tableaux, etc., et SharePoint Foundation sérialise automatiquement les données dans la base de données. Votre classe définit les membres pour les paramètres de propriété, mais, de la classe de base, elle hérite la sérialisation automatique, le stockage et la propagation des paramètres à travers la batterie de serveurs, ainsi que l’invalidation du cache. SharePoint Foundation prend en charge la transmission de vos paramètres à destination et en provenance de la base de données ou applique les paramètres à d’autres serveurs et à d’autres processus, sans qu’il soit nécessaire que vous écriviez du code pour convertir, par exemple, des entiers ou GUID en chaînes.