SPListItemCollectionPosition.PagingInfo property

取得或設定用來產生資料的下一個頁面的分頁資訊。

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

Syntax

'宣告
Public Property PagingInfo As String
    Get
    Set
'用途
Dim instance As SPListItemCollectionPosition
Dim value As String

value = instance.PagingInfo

instance.PagingInfo = value

public string PagingInfo { get; set; }

Property value

Type: System.String
字串，包含分頁資訊。例如，可能包含字串"分頁 = TRUE & p_ID = 9"，其中分頁屬性的值，指出是否資料分頁，而且 ID 屬性的值是ID頁面上的最後一個項目。

Examples

下列範例是一個主控台應用程式，列印清單的項目在網頁中每一頁的三個項目。在每一頁的結尾，應用程式會列印用來產生資料的下一個頁面的PagingInfo屬性的值。

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
                    ' Get a page of data.
                    Dim items As SPListItemCollection = list.GetItems(query)

                    Console.WriteLine(vbCrLf + "Page: {0}  Items: {1}", index, items.Count)

                    ' Print each item ID.
                    Dim item As SPListItem
                    For Each item In items
                        Console.WriteLine("Item ID = {0}", item.ID)
                    Next

                    ' Print the PagingInfo string.
                    If Not items.ListItemCollectionPosition Is Nothing Then
                        Console.WriteLine(items.ListItemCollectionPosition.PagingInfo)
                    End If

                    ' Set the paging information for the next page.
                    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
                    {
                        // Get a page of data.
                        SPListItemCollection items = list.GetItems(query);

                        Console.WriteLine("\nPage: {0}  Items: {1}", index, items.Count);

                        // Print each item ID.
                        foreach (SPListItem item in items)
                            Console.WriteLine("Item ID = {0}", item.ID);

                        // Print the PagingInfo string.
                        if (null != items.ListItemCollectionPosition)
                            Console.WriteLine(items.ListItemCollectionPosition.PagingInfo);

                        // Set the paging information for the next page.
                        query.ListItemCollectionPosition = items.ListItemCollectionPosition;
                        index++;

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

注意事項
如需有關如何使用 Language-Integrated 查詢 (LINQ) 查詢來擷取清單項目，在SharePoint Foundation中的資訊，請參閱Managing Data with LINQ to SharePoint。

請參閱

參照

SPListItemCollectionPosition class

SPListItemCollectionPosition members

Microsoft.SharePoint namespace