SPList-Klasse
Stellt eine Liste auf einer Website Microsoft SharePoint Foundation .
Vererbungshierarchie
System.Object
Microsoft.SharePoint.SPSecurableObject
Microsoft.SharePoint.SPList
Microsoft.SharePoint.SPDocumentLibrary
Microsoft.SharePoint.SPIssueList
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Class SPList _
Inherits SPSecurableObject
'Usage
Dim instance As SPList
public class SPList : SPSecurableObject
Hinweise
Eine Liste enthält Elemente oder Zeilen und Spalten oder Felder, die Daten enthalten. Die Items -Eigenschaft gibt die Auflistung von Elementen in der Liste, und die Fields -Eigenschaft gibt die Auflistung der Felder in der Liste. Zur Verbesserung der Leistung ist es empfehlenswert, eine der GetItem* -Methoden verwenden, um eine gefilterte Auflistung von Elementen in der Liste zurück.
Verschiedene SPList -Eigenschaften ParentList Eigenschaften und andere Eigenschaften oder Methoden für Klassen im Namespace Microsoft.SharePoint Zurückgeben einer Liste oder einer Auflistung von Listen in einem bestimmten Kontext. Verwenden Sie andernfalls die Lists -Eigenschaft der SPWeb oder die SPList -Klasse ein SPListCollection -Objekt, das entweder die Sammlung von Listen in einer Website oder einer Auflistung von übergeordneten Listen eine Liste zurückgeben. Verwenden Sie Indexer, um eine einzelne Liste aus der Auflistung zurückzugeben. Verwenden Sie z. B., wenn die Auflistung in eine Variable namens collListszugewiesen wird, collLists[index] in C# oder collLists(index) in Visual Basic, wobei index die Indexnummer der Liste in der Auflistung der angezeigte Name der Liste ist, oder die GUID der Liste.
Beispiele
Im folgenden Codebeispiel gibt und zeigt Elemente aus einer angegebenen Liste, wobei die Werte im Feld "ProjectedValue" größer als 500 sind. Das Beispiel setzt das Vorhandensein einer ASPX-Seite, die ein Label-Steuerelement enthält.
Dieses Beispiel erfordert using Richtlinien (Imports in Visual Basic) für die Namespaces Microsoft.SharePoint und Microsoft.SharePoint.Utilities .
Dim siteCollection As SPSite = SPContext.Current.Site
Try
Dim list As SPList = siteCollection.AllWebs("Site_Name").Lists("List_Name")
Dim query As New SPQuery()
query.Query = "<Where><Gt><FieldRef Name='ProjectedValue'/>" + "<Value Type='Number'>500</Value></Gt></Where>"
Dim listItems As SPListItemCollection = list.GetItems(query)
Dim listItem As SPListItem
For Each listItem In listItems
Label1.Text += "Item: " + SPHttpUtility.HtmlEncode(listItem("Title").ToString()) +
"::" + "Value: " + SPHttpUtility.HtmlEncode(listItem("Investment").ToString()) +
"::" + "Calculated: " + SPHttpUtility.HtmlEncode(listItem("ProjectedValue").ToString()) + "<BR>"
Next listItem
Finally
siteCollection.Dispose()
End Try
SPSite oSiteCollection = SPContext.Current.Site;
SPList oList = oSiteCollection.AllWebs["Site_Name"].Lists["List_Name"];
SPQuery oQuery = new SPQuery();
oQuery.Query = "<Where><Gt><FieldRef Name='ProjectedValue'/>" +
"<Value Type='Number'>500</Value></Gt></Where>";
SPListItemCollection collListItems = oList.GetItems(oQuery);
foreach (SPListItem oListItem in collListItems)
{
Label1.Text += "Item: " +
SPHttpUtility.HtmlEncode(oListItem["Title"].ToString()) +
"::" + "Value: " +
SPHttpUtility.HtmlEncode(oListItem["Investment"].ToString()) +
"::" + "Calculated: " +
SPHttpUtility.HtmlEncode(oListItem["ProjectedValue"].ToString()) +
"<BR>";
}
}
Nach der Instanziierung eines Objekts SPQuery , verwendet das Beispiel Collaborative Application Markup Language (CAML) zum Definieren von Kriterien für die Abfrage, der als Parameter in der GetItems -Methode übergeben wird. Informationen über CAML finden Sie unter Collaborative Application Markup Language.
Hinweis
Informationen dazu, wie Sie Abfragen (Language-Integrated Query, LINQ) verwenden, um Listenelemente in SharePoint Foundationabzurufen finden Sie unter Managing Data with LINQ to SharePoint.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.