Compartilhar via


SPListItemCollection.ListItemCollectionPosition property

Obtém um objeto que é usado para obter o próximo conjunto de linhas em uma exibição de uma lista de paginado.

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

Syntax

'Declaração
Public ReadOnly Property ListItemCollectionPosition As SPListItemCollectionPosition
    Get
'Uso
Dim instance As SPListItemCollection
Dim value As SPListItemCollectionPosition

value = instance.ListItemCollectionPosition
public SPListItemCollectionPosition ListItemCollectionPosition { get; }

Property value

Type: Microsoft.SharePoint.SPListItemCollectionPosition
As informações de paginação.

Comentários

A propriedade ListItemCollectionPosition retorna a null reference (Nothing in Visual Basic) se o número de itens na coleção é menor do que o limite de linha para uma página.

Examples

O exemplo a seguir é um aplicativo de console que imprime itens de lista em páginas com três itens por página.

Imports System
Imports Microsoft.SharePoint

Module Test

    Sub Main()
        Using site As SPSite = New SPSite("https://localhost")
            Using web As SPWeb = site.OpenWeb()

                Dim list As SPList = web.GetList("/lists/announcements")

                Dim query As SPQuery = New SPQuery()
                query.RowLimit = 3

                ' Print list items in pages with query.RowLimit items per page.
                Dim index As Integer = 1
                Do
                    Dim items As SPListItemCollection = list.GetItems(query)
                    Console.WriteLine(vbCrLf + "Page: {0}  Items: {1}", index, items.Count)

                    For Each item As SPListItem In items
                        Console.WriteLine(item.Title)
                    Next

                    query.ListItemCollectionPosition = items.ListItemCollectionPosition
                    index = index + 1

                    ' ListItemCollectionPosition is null for the last batch.
                Loop Until query.ListItemCollectionPosition Is Nothing

            End Using
        End Using
        Console.ReadLine()
    End Sub

End Module
using System;
using Microsoft.SharePoint;

namespace Test
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                using (SPWeb web = site.OpenWeb())
                {
                    SPList list = web.GetList("/lists/announcements");

                    SPQuery query = new SPQuery();
                    query.RowLimit = 3;

                    // Print list items in pages with query.RowLimit items per page.
                    int index = 1;
                    do
                    {
                        SPListItemCollection items = list.GetItems(query);
                        Console.WriteLine("\nPage: {0}  Items: {1}", index, items.Count);

                        foreach (SPListItem item in items)
                            Console.WriteLine(item.Title);

                        
                        query.ListItemCollectionPosition = items.ListItemCollectionPosition;
                        index++;

                    } // ListItemCollectionPosition is null for the last batch.
                    while (query.ListItemCollectionPosition != null); 
                }
            }
            Console.ReadLine();
        }
    }
}

Ver também

Referência

SPListItemCollection class

SPListItemCollection members

Microsoft.SharePoint namespace

ListItemCollectionPosition