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("http://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>";

    }
}

Siehe auch

Referenz

SPList Klasse

SPList-Member

Microsoft.SharePoint-Namespace