Bloc de construction : listes et bibliothèques de documents

Article
09/24/2014

Dernière modification : jeudi 8 avril 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Modèle objet pour les listes et les bibliothèques de documents
Code XML utilisé pour les listes et les bibliothèques de documents
Domaines liés aux listes et aux bibliothèques de documents
Informations supplémentaires sur les listes et les bibliothèques de documents

Microsoft SharePoint Foundation 2010 propose plusieurs API permettant d’utiliser des listes. Les modèles objet managé suivants fournissent des types et des membres qui vous permettent de modifier des propriétés de liste et de créer et gérer des modèles de liste et des éléments de liste :

Pour du code qui fonctionne sur le serveur, l’espace de noms Microsoft.SharePoint fournit les classes de base qui représentent une liste. L’espace de noms Microsoft.SharePoint.Deployment fournit une API pour la migration de contenu entre les collections de sites.
Pour du code managé qui fonctionne dans le contexte d’applications Microsoft .NET 3.5 ou d’applications Silverlight côté client, l’espace de noms Microsoft.SharePoint.Client fournit un sous-ensemble des types et des membres disponibles dans le modèle objet serveur.
Pour un script qui fonctionne dans le navigateur, le modèle objet ECMAScript (JavaScript, JScript) de l’espace de noms SP fournit un sous-ensemble des types et des membres disponibles dans le modèle objet serveur.
Le service Web Lists fournit des méthodes permettant d’utiliser des listes à distance.

Vous pouvez utiliser la méthode SaveAsTemplate(String, String, String, Boolean) dans le modèle objet côté serveur pour enregistrer une liste SharePoint Foundation existante en tant que modèle de liste, ou utiliser la classe SPListTemplate et sa classe de collection pour gérer des modèles de liste. La classe SPListTemplate représente des modèles de liste personnalisés, que vous créez à l’aide de la méthode SaveAsTemplate(String, String, String, Boolean) ou enregistrez via l’interface utilisateur, et des définitions de liste, que vous installez et activez sous forme de composant fonctionnel dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.

Un schéma de liste contient un type de base et un type de modèle de liste. L’énumération SPBaseType identifie les types de base de liste suivants :

Type de liste générique pour la plupart des listes
Bibliothèque de documents
Forum de discussion
Enquête
Problème
Type de base non spécifié

L’énumération SPListTemplateType identifie les types de modèle de liste par défaut dans SharePoint Foundation, chacun d’entre eux étant associé à une définition de type de base de liste unique. La classe SPList donne accès aux propriétés de liste communes à toutes les listes, mais les types de modèle de liste peuvent également dériver d’un type de base de liste. Par exemple, vous pouvez convertir un objet de liste qui représente une bibliothèque de document en objet SPDocumentLibrary pour accéder aux propriétés spécifiques de bibliothèques de documents.

Microsoft Microsoft Business Connectivity Services (BCS) fournit des API destinées aux listes externes. Pour plus d’informations sur Business Connectivity Services, voir Bloc de construction : types de contenu externes et listes externes.

Modèle objet pour les listes et les bibliothèques de documents

Les classes suivantes dans les modèles objet serveur et client permettent d’utiliser des listes, des modèles de listes et des éléments de liste :

SPList – Représente une liste dans un site Web SharePoint. La méthode GetList de SPWeb ou SPListCollection permet de renvoyer efficacement une liste spécifique.

Modèle objet client : List (JavaScript : List)
SPListDataSource – Fournit des informations sur une liste externe.

Modèle objet client : ListDataSource (JavaScript : ListDataSource)
SPListEventProperties – Fournit des propriétés pour les événements de liste SharePoint.
SPListEventReceiver – Fournit des méthodes pour intercepter les événements qui se produisent au niveau des listes.
SPListItem – Représente un élément ou une ligne dans une liste. Pour renvoyer un élément de liste ou un SPListItemCollection, la méthode GetItem* de SPList ou SPWeb constitue un moyen efficace.

Modèle objet client : ListItem (JavaScript : ListItem)
SPListItemVersion – Représente une version d’un élément de liste.
SPListTemplate – Représente une définition de liste ou un modèle de liste qui définit les champs et les vues pour une liste. Les définitions de liste sont contenues dans des fichiers dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES, mais les modèles de listes sont créés par l’intermédiaire de l’interface utilisateur ou du modèle objet lorsqu’une liste est enregistrée en tant que modèle.

Modèle objet client : ListTemplate (JavaScript : ListTemplate)
SPListTemplateType – Énumération qui spécifie le type d’une définition de liste ou d’un modèle de liste.

Modèle objet client : ListTemplateType (JavaScript : ListTemplateType)
SPBaseType – Énumération qui spécifie le type de base pour une liste.

Modèle objet client : BaseType (JavaScript : BaseType)
SPDocTemplate – Représente un modèle de document utilisé dans une bibliothèque de documents.
SPDocumentLibrary – Représente une bibliothèque de documents dans SharePoint Foundation.

Pour plus d’informations sur l’utilisation de listes dans le modèle objet serveur, voir Utilisation des objets Liste et des collections et les tâches de programmation incluses dans Tâches du modèle objet de base. Pour plus d’informations sur l’utilisation des liste dans les modèles objet client, voir Vue d'ensemble de la récupération des données et les tâches de programmation dans Tâches courantes de programmation.

Code XML utilisé pour les listes et les bibliothèques de documents

Une définition de liste est activée sous forme d’un composant fonctionnel SharePoint Foundation et possède un fichier Schema.xml qui contient le schéma, bien que la majeure partie de la définition de l’affichage soit fournie par l’intermédiaire de XSLT dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\XSL. List est l’élément de niveau supérieur dans le schéma de liste, mais l’élément Configuration dans un schéma de définition de site contient également un élément List pour inclure une liste spécifique dans le cadre de sites Web qui sont créés par le biais de la définition du site. Le composant fonctionnel List Instance vous permet de spécifier les données par défaut avec lesquelles mettre en service un type de liste. Pour plus d’informations sur l’utilisation des composants fonctionnels, voir Utilisation des fonctionnalités. Pour obtenir un exemple qui montre comment créer une définition de liste Composant fonctionnel, voir Procédure : créer une définition de liste personnalisée.