QueryExpression を使用して大きな結果セットをページングする


公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

Microsoft Dynamics 365 (オンラインおよび設置型) では、ページング Cookie 機能を使用して、アプリケーション内での大きなデータセットのページングを高速化できます。 この機能は、FetchXML クエリと QueryExpression クエリの両方で使用できます。 レコード セットのクエリにページング Cookie 機能を使用すると、クエリ結果にページング Cookie の値が含まれます。 システムのパフォーマンスを向上するには、次のレコード セットを取得するときにこの値を渡します。

QueryExpression と FetchXML では、ページング Cookie の形式が異なります。QueryExpressionToFetchXmlRequest メッセージまたはFetchXmlToQueryExpressionRequest メッセージを使用して、クエリ形式を別の形式に変換すると、ページング Cookie の値は無視されます。 また、連続していないページを要求した場合も、ページング Cookie の値は無視されます。

次のサンプルは、ページング Cookie をクエリ式で使用する方法を示しています。 完全なサンプル コードについては、「サンプル: ページング Cookie を使用した QueryExpression の使用」を参照してください。

// Query using the paging cookie.
// Define the paging attributes.
// The number of records per page to retrieve.
int queryCount = 3;

// Initialize the page number.
int pageNumber = 1;

// Initialize the number of records.
int recordCount = 0;

// Define the condition expression for retrieving records.
ConditionExpression pagecondition = new ConditionExpression();
pagecondition.AttributeName = "parentaccountid";
pagecondition.Operator = ConditionOperator.Equal;

// Define the order expression to retrieve the records.
OrderExpression order = new OrderExpression();
order.AttributeName = "name";
order.OrderType = OrderType.Ascending;

// Create the query expression and add condition.
QueryExpression pagequery = new QueryExpression();
pagequery.EntityName = "account";
pagequery.ColumnSet.AddColumns("name", "emailaddress1");                   

// Assign the pageinfo properties to the query expression.
pagequery.PageInfo = new PagingInfo();
pagequery.PageInfo.Count = queryCount;
pagequery.PageInfo.PageNumber = pageNumber;

// The current paging cookie. When retrieving the first page, 
// pagingCookie should be null.
pagequery.PageInfo.PagingCookie = null;
Console.WriteLine("Retrieving sample account records in pages...\n");
Console.WriteLine("#\tAccount Name\t\tEmail Address"); 

while (true)
    // Retrieve the page.
    EntityCollection results = _serviceProxy.RetrieveMultiple(pagequery);
    if (results.Entities != null)
        // Retrieve all records from the result set.
        foreach (Account acct in results.Entities)
            Console.WriteLine("{0}.\t{1}\t{2}", ++recordCount, acct.Name,

    // Check for more records, if it returns true.
    if (results.MoreRecords)
        Console.WriteLine("\n****************\nPage number {0}\n****************", pagequery.PageInfo.PageNumber);
        Console.WriteLine("#\tAccount Name\t\tEmail Address");

        // Increment the page number to retrieve the next page.

        // Set the paging cookie to the paging cookie returned from current results.
        pagequery.PageInfo.PagingCookie = results.PagingCookie;
        // If no more records are in the result nodes, exit the loop.


QueryExpression でクエリを作成する
サンプル: ページング Cookie を使用した QueryExpression の使用
サンプル: 一対多関連付けでの取得
QueryExpression クラスの使用
FetchXML による大量の結果セットのページング

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権