Bloc de construction : requêtes et affichages
Dernière modification : lundi 5 avril 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Modèle objet pour les requêtes et les affichages
XML utilisé pour les requêtes et les affichages
Modèle objet pour le fournisseur LINQ to SharePoint
XML utilisé pour SPMetal
Aspects liés au développement de requêtes et d’affichages
Informations supplémentaires sur les requêtes et les affichages
Dans Microsoft SharePoint Foundation 2010, une requête détermine les données de site ou de liste qui sont renvoyées, tandis qu’un affichage détermine le mode d’affichage des données dans la page. Un affichage contient toujours une requête, mais une requête n’est pas toujours associée à un affichage, car une requête peut être utilisée indépendamment d’un affichage dans un contexte de code managé. Il est possible de partager les affichages sous forme de styles d’affichage dans plusieurs listes d’un site Web.
Le langage CAML (Collaborative Application Markup Language) a jusqu’à présent été le principal moyen utilisé pour définir des requêtes et des affichages dans SharePoint Foundation. Vous pouvez utiliser une chaîne CAML pour définir une requête dans le contexte du modèle objet serveur ou du modèle objet client. Toutefois, SharePoint Foundation 2010 propose une autre méthode pour définir des requêtes sans passer par le langage CAML. Désormais, vous pouvez interroger les données SharePoint directement à l’aide du nouveau fournisseur LINQ to SharePoint, qui vous permet d’interroger des listes de requêtes à partir de code serveur qui utilise la syntaxe LINQ (Language Integrated Query). SPMetal est un outil de ligne de commande que vous pouvez utiliser pour générer des classes d’entité, qui à son tour fournit une interface orientée objet pour les bases de données de contenu SharePoint Foundation.
Modèle objet pour les requêtes et les affichages
En cas d’utilisation de code serveur qui utilise l’espace de noms Microsoft.SharePoint, vous définissez une requête en instanciant un objet SPQuery et en assignant une chaîne en CAML qui affecte la propriété Query à la requête. Ensuite, vous passez l’objet SPQuery en tant que paramètre dans la méthode GetItems() de l’objet SPList pour renvoyer les éléments de liste spécifiés.
Le code client qui utilise le nouvel espace de noms Microsoft.SharePoint.Client (JavaScript : espace de noms SP) fonctionne de manière similaire. Dans le code client, vous pouvez définir une requête en instanciant un objet CamlQuery (JavaScript : CamlQuery) et en assignant une chaîne de requête CAML à la propriété ViewXml (JavaScript : viewXml). Passez ensuite CamlQuery en tant que paramètre dans la méthode GetItems(CamlQuery) (JavaScript : getItems) de List (JavaScript : List) pour renvoyer les éléments de liste spécifiés.
Les classes les plus importantes lors de l’utilisation d’affichages et de requêtes dans le serveur et les modèles d’objet client sont les suivantes :
SPQuery - Définit une requête.
SPView – Représente un affichage des données de liste. Un affichage contient une requête. La propriété Views de SPList donne accès au SPViewCollection de la liste.
SPViewFieldCollection – Représente la collection de champs qui sont renvoyés dans un affichage.
Modèle objet client : ViewFieldCollection (JavaScript: ViewFieldCollection)
SPViewStyle - Représente un style d’affichage. La propriété ViewStyles de SPWeb donne accès au SPViewStyleCollection pour un site Web.
Pour plus d’informations sur l’utilisation des requêtes dans le modèle objet serveur, voir Procédure : renvoyer des éléments à partir d'une liste. Pour plus d’informations sur l’utilisation de requêtes dans le modèle objet client, voir Vue d'ensemble de la récupération des données et Procédure : récupérer des éléments de liste.
XML utilisé pour les requêtes et les affichages
Le schéma d’affichage CAML contient une requête CAML, bien que le schéma de requête soit souvent utilisé dans des contextes en dehors du schéma d’affichage. Un affichage est contenu dans le fichier Schema.xml pour une liste, qui se trouve dans le dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURE pour une définition de liste. Dans SharePoint Foundation 2010, une grande partie de l’affichage est définie via XSLT dans les fichiers .xsl situés dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\XSL. Pour plus d’informations sur les vues XSLT, voir Affichages de liste. SharePoint Foundation 2010 propose de nouveaux éléments Joins et ProjectFields que l’élément View peut contenir, ce qui permet à un affichage de liste d’inclure des champs provenant d’autres listes qui ont été liées à la liste principale.
Pour plus d’informations sur la structure des schémas d’affichage et de requête et leurs éléments, voir Schéma d'affichage et Schéma de requête.
Modèle objet pour le fournisseur LINQ to SharePoint
L’espace de noms Microsoft.SharePoint.Linq fournit les classes importantes suivantes qui sont utilisées pour mettre en œuvre le fournisseur LINQ to SharePoint.
DataContext - Classe de passerelle principale qui donne accès à SharePoint Foundation et qui offre des fonctionnalités de création de requêtes LINQ, d’écriture dans les bases de données de contenu et de gestion de la modification des objets. GetList<T>(String) renvoie un objet EntityList<TEntity> qui représente une liste pouvant être interrogée, et SubmitChanges() écrit les modifications dans la base de données de contenu.
EntityList<TEntity> - Représente une liste SharePoint Foundation qui peut être interrogée via LINQ. Utilisée conjointement avec d’autres « classes d’entité » qui représentent des éléments de liste et des valeurs de champ, cette liste fournit un mappage relationnel objet et une interface entre le code .NET orienté objet et la structure relationnelle des bases de données de contenu.
EntityRef<TEntity> - Classe d’entité qui assure le chargement différé et la maintenance des relations pour la partie singleton d’une relation un-à-plusieurs.
EntitySet<TEntity> - Classe d’entité qui assure le chargement différé et la maintenance des relations pour la partie « plusieurs » de relations un-à-plusieurs et plusieurs à plusieurs.
LookupList<T> - Classe d’entité qui représente les valeurs d’un champ de recherche (colonne) acceptant plusieurs valeurs.
Pour plus d’informations sur les autres classes importantes qui peuvent être utilisées avec le fournisseur LINQ to SharePoint, voir Microsoft.SharePoint.Linq. Pour obtenir une vue d’ensemble et les tâches de programmation qui décrivent le fournisseur, voir Gestion des données avec LINQ to SharePoint.
XML utilisé pour SPMetal
Schéma du code XML des paramètres de SPMetal est utilisé pour substituer certains aspects du comportement par défaut de SPMetal. En particulier, il détermine les entités de base de données de contenu qui sont incluses dans les classes d’entité que l’outil génère. Pour plus d’informations sur le mode d’utilisation de l’outil et de son schéma, voir SPMetal.
Aspects liés au développement de requêtes et d’affichages
Bloc de construction : listes et bibliothèques de documents