Compartilhar via


SPList.Items property

Obtém uma coleção não filtrada de todos os itens na lista.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public ReadOnly Property Items As SPListItemCollection
    Get
'Uso
Dim instance As SPList
Dim value As SPListItemCollection

value = instance.Items
public SPListItemCollection Items { get; }

Property value

Type: Microsoft.SharePoint.SPListItemCollection
Um objeto SPListItemCollection que representa a coleção de itens.

Comentários

A propriedade Items retorna todos os arquivos em uma biblioteca de documentos, incluindo os arquivos nas subpastas, mas não as pastas em si. Em uma biblioteca de documentos, as pastas não são consideradas itens.

Quando você chamar a propriedade Items , ele retorna uma instância de um objeto SPListItemCollection que não contêm quaisquer dados, mas no primeiro acesso a um item da coleção, o objeto de coleção inteira será preenchido com dados. Consequentemente, para melhorar o desempenho é recomendável que você atribua itens retornados pela Items a um objeto SPListItemCollection se você deve iterar toda a coleção, como visto no exemplo. É melhor prática é usar um dos métodos de SPListGetItem* para retornar uma coleção filtrada de itens.

Examples

O exemplo a seguir exibe os itens de uma lista de projeto dentro de um rótulo. O exemplo atribui os itens que são retornados pela propriedade Items para um objeto SPListItemCollection e, em seguida, itera através da coleção. O exemplo não usa oList.Items[i] dentro do loop de for .

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>";

    }
}

Ver também

Referência

SPList class

SPList members

Microsoft.SharePoint namespace