SPQuery - Classe
Représente une requête dans une liste.
Hiérarchie d’héritage
System.Object
Microsoft.SharePoint.SPQuery
Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Class SPQuery
'Utilisation
Dim instance As SPQuery
public class SPQuery
Remarques
L'attribut Type est particulièrement utile pour les champs liste de choix et de l'utilisateur. Dans le cas contraire, sans cet attribut, la requête ne peut pas retourner les résultats attendus. Dans certains cas, la requête peut échouer.
Pour plus d'informations sur la façon d'utiliser des requêtes de Language-Integrated Query (LINQ) pour récupérer des éléments de liste dans SharePoint Foundation, voir Managing Data with LINQ to SharePoint.
Exemples
L'exemple de code suivant affiche les titres des éléments dans une liste de tâches dans laquelle la colonne d'état est achevé. L'exemple utilise le Langage CAML (Collaborative Application Markup Language) pour définir la requête.
Cet exemple requiert les directives using (Imports dans Visual Basic) pour les espaces de noms Microsoft.SharePoint et Microsoft.SharePoint.Utilities .
Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Dim list As SPList = webSite.Lists("Tasks")
Dim query As New SPQuery()
query.Query = "<Where><Eq><FieldRef Name='Status'/>" + _
"<Value Type='Text'>Completed</Value></Eq></Where>"
Dim items As SPListItemCollection = list.GetItems(query)
Dim item As SPListItem
For Each item In items
Response.Write((SPEncode.HtmlEncode(item("Title").ToString()) + _
"<BR>"))
Next item
SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb
SPList oList = oWebsiteRoot.Lists["Tasks"];
SPQuery oQuery = new SPQuery();
oQuery.Query = "<Where><Eq><FieldRef Name='Status'/>" +
"<Value Type='Text'>Completed</Value></Eq></Where>";
SPListItemCollection collListItems = oList.GetItems(oQuery);
foreach (SPListItem oListItem in collListItems)
{
Response.Write(SPEncode.HtmlEncode(oListItem["Title"].ToString()) +
"<BR>");
}
Cohérence de thread
Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.