SPQuery-Klasse
Stellt eine Abfrage in einer Listenansicht angezeigt.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.SPQuery
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Class SPQuery
'Usage
Dim instance As SPQuery
public class SPQuery
Hinweise
Das Attribut Type ist besonders nützlich für Suche und Benutzer. Andernfalls kann die Abfrage ohne dieses Attribut nicht die erwarteten Ergebnisse zurück. In einigen Fällen kann die Abfrage vollständig fehl.
Informationen dazu, wie Sie Abfragen (Language-Integrated Query, LINQ) verwenden, um Listenelemente in SharePoint Foundationabzurufen finden Sie unter Managing Data with LINQ to SharePoint.
Beispiele
Das folgende Codebeispiel zeigt die Titel der Elemente in einer Aufgabenliste, in die Spalte Status abgeschlossen gleich ist. Im Beispiel wird Collaborative Application Markup Language (CAML) verwendet, um die Abfrage zu definieren.
Dieses Beispiel erfordert using Richtlinien (Imports in Visual Basic) für die Namespaces Microsoft.SharePoint und 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>");
}
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.