Paging op grote resultaatsets toepassen met QueryExpression

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In Microsoft Dynamics 365 (online en on-premises) kunt u de pagina-cookiefunctie gebruiken om paging in een toepassing sneller te maken voor grote gegevenssets. De functie is beschikbaar in zowel FetchXML- als QueryExpression-query's. Als u de paging-cookiefunctie gebruikt om een set records op te vragen, bevat het resultaat een waarde voor de paging-cookie. Om de systeemprestaties te verbeteren kunt u deze waarde vervolgens doorgeven wanneer u de volgende set records ophaalt.

QueryExpression en FetchXML gebruiken verschillende indelingen voor hun paging-cookies. Als u van de ene queryindeling naar de andere converteert met het bericht QueryExpressionToFetchXmlRequest of het bericht FetchXmlToQueryExpressionRequest, wordt de paging-cookiewaarde genegeerd. Als u niet-opeenvolgende pagina's opvraagt, wordt de paging-cookiewaarde ook genegeerd.

Een paging-cookie gebruiken met QueryExpression

Dit voorbeeld laat zien hoe u de paging-cookie gebruikt met een query-expressie. Als u het volledige voorbeeld wilt bekijken, raadpleegt u Voorbeeld: QueryExpression gebruiken met een paging-cookie.

// 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;
pagecondition.Values.Add(_parentAccountId);

// 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.Criteria.AddCondition(pagecondition);
pagequery.Orders.Add(order);
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,
                               acct.EMailAddress1);
        }
    }

    // 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.
        pagequery.PageInfo.PageNumber++;

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

Zie ook

Bouw query's met QueryExpression
Voorbeeld: QueryExpression gebruiken met een paging-cookie
Voorbeeld: Ophalen met een-op-veel-relatie
De klasse QueryExpression gebruiken
Paging op grote resultaatsets toepassen met FetchXML

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht