La hiérarchie de contenu de Microsoft SharePoint Foundation
Dernière modification : samedi 13 mars 2010
S’applique à : SharePoint Foundation 2010
Le modèle objet Microsoft SharePoint Foundation peut être fractionné utilement en trois hiérarchies. Cette rubrique décrit la Hiérarchie de contenu, qui inclut des classes qui représentent des éléments de données publiables, tels que des éléments de liste. Il y a aussi des classes qui représentent des conteneurs de données imbriqués, tels que des listes, des bases de données de contenu, des sites Web, des collections de sites Web et des regroupements de collections de sites appelés applications Web.
Important
Vous trouverez des détails sur les entités qui sont représentées par les classes de la hiérarchie dans Informations de base : entités de contenu dans Microsoft SharePoint Foundation.
La Hiérarchie d'objets physiques, qui inclut des classes qui représentent des entités physiques telles que des serveurs et des fichiers, ainsi que les conteneurs de ces entités parmi lesquels les batteries de serveurs et les dossiers, est décrite dans La hiérarchie des objets physiques de Microsoft SharePoint Foundation.
La troisième hiérarchie, la Hiérarchie des services, inclut des classes qui représentent des services et des instances de services. Elle est décrite dans Hiérarchie des services de Microsoft SharePoint Foundation.
Notes
Ces hiérarchies se recoupent, car certaines classes ne sont pas faciles à classer et peuvent appartenir à plus d'une hiérarchie.
La hiérarchie de contenu
Les sept classes principales de la hiérarchie de contenu sont illustrées dans la figure 1.
Figure 1. Les principaux objets de la hiérarchie de contenu
.gif "Objets principaux de la hiérarchie de contenu")
Chaque type d'objet de la Figure 1 contient des objets du type situé sous lui. Les classes SPList, SPListItem et SPField ne sont pas traitées dans cette rubrique.
SPWeb
Un objet SPWeb représente un site Web SharePoint Foundation. Certaines caractéristiques de la classe SPWeb sont les suivantes :
Un objet SPWeb peut être un enfant d'un autre objet SPWeb ou d'un objet SPSite. S'il s'agit de l'enfant d'un objet SPSite, c'est le site Web de niveau supérieur dans sa collection de sites.
Un objet SPWeb possède une propriété Webs qui renvoie une collection d'autres objets SPWeb ; plus précisément les sous-sites enfants situés immédiatement en dessous.
La classe comporte un ensemble très intéressant de membres destinés à l'administration et la personnalisation du site Web par la programmation.
Une hiérarchie de sites Web a toujours exactement un site Web de niveau supérieur. Ce site est l'enfant d'un objet SPSite.
Notes
Ce qu'on appelle un « site Web » (ou simplement « site ») dans SharePoint Foundation s'appelait « Web » dans la version originale de SharePoint Foundation—Microsoft SharePoint Team Services. Par conséquent, la classe qui le représente s'appelle SPWeb. De même, une collection de sites était simplement un « site », c'est pourquoi la classe qui représente une collection de sites s'appelle SPSite.
SPSite
Un objet SPSite représente une collection de sites Web, mais la classe SPSite n'est pas une collection dans le sens d'une classe qui implémente ICollection. (Une classe SPSiteCollection implémente la dernière interface. Elle représente une collection d'objets SPSite.)
Certaines caractéristiques de la classe SPSite sont notamment :
Un objet SPSite représente un sous-ensemble du contenu d'un objet SPContentDatabase.
La classe SPSite possède une propriété RootWeb qui contient son site Web de niveau supérieur enfant. (Les sites Web de niveau supérieur s'appelaient « sites Web racines » dans la première version de SharePoint Foundation, Microsoft SharePoint Team Services.) À son tour, l'objet SPWeb qui représente le site Web de niveau supérieur possède une propriété Webs qui contient tous ses sous-sites enfants immédiats (mais pas les sous-sites de ces sous-sites). (La propriété AllWebs renvoie tous les sous-sites et le site Web de niveau supérieur.)
SPSite comporte de nombreux membres que vous pouvez utiliser pour développer la fonctionnalité d'administration. Parmi les plus importants, certains facilitent l'administration dans les domaines suivants :
La longueur maximale des URL des sites Web
Flux RSS
Audit
Sites Web qui ne répondent plus
Composants fonctionnels
Propriétaire de la collection de sites
Quotas de taille pour la collection de sites
Données d'utilisation des sites
Flux de travail dans la collection de sites
Modèles et galeries de composants WebPart
Création de sites en libre-service
À peu près la moitié des méthodes de la classe SPSite sont des méthodes Get* qui renvoient des informations d'un certain type et la plupart des propriétés sont en lecture seule.
SPContentDatabase
Un objet SPContentDatabase représente une base de données SQL Server qui contient toutes les données (listes, éléments de liste, billets et commentaires de blog, pages wiki et documents des bibliothèques de documents) et la plupart des fichiers de page qui constituent les collections de sites appartenant à la base de données.
Certaines caractéristiques de la classe SPContentDatabase :
Un objet SPContentDatabase est enfant d'un objet SPWebApplication. La collection de bases de données de contenu d'une application Web est référencée dans la propriété ContentDatabases de cette application Web.
La classe SPContentDatabase possède une propriété Sites qui contient tous ses objets SPSite enfants.
SPContentDatabase hérite de SPPersistedObject, ce qui signifie qu'un objet qui instancie la classe demeure dans la base de données de configuration.
SPContentDatabase comporte de nombreux membres qui peuvent être utilisés pour développer des fonctionnalités d'administration. Certains des membres les plus importants peuvent faciliter l'administration de :
Sauvegarde et restauration de la base de données
Mises à niveau de la base de données
Migration (déplacement) de la base de données
Réparations de la base de données
Chaîne de connexion à la base de données et nom d'utilisateur et mot de passe de connexion
Limitation du nombre de collections de sites
La plupart des propriétés de SPContentDatabase sont en lecture seule.
SPWebApplication
Un objet SPWebApplication représente une application Web de publication de contenu dans SharePoint Foundation. Il contient une ou plusieurs bases de données de contenu stockant les données d'une ou plusieurs collections de sites. Chacune de ces applications Web est desservie par un site Web ISS et elle possède généralement son propre pool d'applications dans ISS.
Certaines caractéristiques de la classe SPWebApplication :
Un objet SPWebApplication est enfant d'un objet SPWebService. (Pour plus d'informations sur la classe SPWebService, voir Hiérarchie des services de Microsoft SharePoint Foundation.)
La classe SPWebApplication possède une propriété ContentDatabases qui contient tous ses objets SPContentDatabase enfants. (Elle possède aussi une propriété Sites qui permet d'obtenir une référence à toutes les collections de sites de toutes ses bases de données de contenu sans commencer par récupérer une référence à une ou plusieurs des bases de données de contenu.)
Comme l'application Administration centrale, la classe SPWebApplication permet aux administrateurs d'accéder aux propriétés IIS sans ouvrir le gestionnaire IIS. Par exemple, il y a une propriété IisSettings, et il y a une propriété ApplicationPool qui fournit un accès par la programmation aux propriétés du pool d'applications IIS auquel l'application Web SharePoint Foundation est affectée.
SPWebApplication hérite de SPPersistedObject, ce qui signifie qu'un objet de la classe demeure dans la base de données de configuration. (Pour plus d'informations sur l'utilisation de ces objets dans votre code, voir Vue d’ensemble : utiliser le modèle objet pour personnaliser l’administration et Procédure pas à pas : créer un objet de service de contenu.)
SPWebApplication comporte de nombreux membres qui peuvent être utilisés pour développer des fonctionnalités d'administration. Certains des membres les plus importants peuvent faciliter l'administration de :
Stratégie de sécurité
Alertes
Conversions de document
Sauvegardes et restaurations de l'application Web
Consignation dans un journal des modifications apportées à l'application Web
Messages sortants
Participation du flux de travail externe
Utilisation de l'API MetaWeblog Windows Live
Utilisation de la Corbeille
Collections de sites inutilisées
Modifications du fichierWeb.config
Quand une application Web doit consommer des données ou une fonctionnalité de traitement fournie par une application de service, elle le fait par le biais de SPServiceApplicationProxy.
La classe SPWebApplication est étroitement liée à la classe SPHttpApplication. Les objets de cette dernière sont des gestionnaires de requêtes HTTP. Le processus (pool d'applications IIS) auquel une application Web SharePoint Foundation est affectée possède un ou plusieurs objets SPHttpApplication qui gèrent les demandes de page envoyées à l'application Web.
Voir aussi
Référence
Concepts
Serveur et architecture du site : vue d'ensemble du modèle objet
Utilisation des objets Liste et des collections
Vue d’ensemble : utiliser le modèle objet pour personnaliser l’administration
Exemple de code : utilisation du modèle objet Administration
La hiérarchie de contenu de Microsoft SharePoint Foundation
Informations de base : entités de contenu dans Microsoft SharePoint Foundation
La hiérarchie des objets physiques de Microsoft SharePoint Foundation
Informations de base : objets physiques dans Microsoft SharePoint Foundation
Hiérarchie des services de Microsoft SharePoint Foundation
Informations de base : entités de service dans Microsoft SharePoint Foundation
Autres ressources
Le modèle objet administratif de Microsoft SharePoint Foundation