SPList.Items-Eigenschaft
Ruft eine ungefilterte Auflistung aller Elemente in der Liste.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public ReadOnly Property Items As SPListItemCollection
Get
'Usage
Dim instance As SPList
Dim value As SPListItemCollection
value = instance.Items
public SPListItemCollection Items { get; }
Eigenschaftswert
Typ: Microsoft.SharePoint.SPListItemCollection
Ein SPListItemCollection -Objekt, das die Auflistung von Elementen darstellt.
Hinweise
Die Items -Eigenschaft gibt alle Dateien in einer Dokumentbibliothek, einschließlich der Dateien in den Unterordnern, aber nicht die Ordner selbst. In einer Dokumentbibliothek werden Ordner nicht als Elemente betrachtet.
Wenn Sie die Items -Eigenschaft aufrufen, wird eine Instanz eines SPListItemCollection -Objekts, das keine Daten enthält, aber beim ersten Zugriff auf ein Element aus der Auflistung, das gesamte Auflistungsobjekt mit Daten gefüllt wird. Aus diesem Grund wird zur Verbesserung der Leistung empfohlen, weisen Sie die zurückgegebenen Elemente von Items zu einem SPListItemCollection -Objekt, wenn Sie die gesamte Auflistung durchlaufen müssen wie im Beispiel gezeigt. Es ist am besten Vorgehensweise besteht darin, eine der Methoden GetItem*SPList verwenden, um eine gefilterte Auflistung von Elementen zurück.
Beispiele
Das folgende Beispiel zeigt die Elemente einer Liste Projekt innerhalb eines Bezeichnungsfeldes. Das Beispiel weist die Elemente, die von der Items -Eigenschaft auf ein SPListItemCollection -Objekt zurückgegeben werden und durchläuft dann die Auflistung. Im Beispiel wird die oList.Items[i] in der Schleife for nicht verwendet.
Using oWebsite As SPWeb = New SPSite("http://lsspf4719/sites/TestWebs").OpenWeb()
Dim oList As SPList = oWebsite.Lists("Projects")
Dim collItem As SPListItemCollection = oList.Items
For i As Integer = 0 To oList.ItemCount - 1
Dim itemName As String = collItem(i).Name
Label1.Text += itemName & "<BR>"
Next
End Using
using (SPWeb oWebsite = new SPSite("https://Server/sites/SiteCollection").OpenWeb())
{
SPList oList = oWebsite.Lists["Projects"];
SPListItemCollection collItem = oList.Items;
for (int i = 0; i < oList.ItemCount; i++)
{
string itemName = collItem[i].Name;
Label1.Text += itemName + "<BR>";
}
}