Sideopdele store resultatsæt med QueryExpression

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

I Microsoft Dynamics 365 (online og i det lokale miljø) kan du bruge sideopdelingscookie-funktionen til at foretage hurtigere sideopdeling i et program for store datasæt. Funktionen er tilgængelig i både FetchXML- og QueryExpression-forespørgsler. Når du bruger sideopdelingscookie-funktionen, når du forespørger på et sæt poster, viser resultatet en værdi for sideopdelingscookien. For at forbedre systemets ydeevne kan du derefter sende denne værdi, når du henter det næste sæt poster.

QueryExpression og FetchXML bruger forskellige formater for deres sideopdelingscookies. Hvis du konverterer fra ét forespørgselsformat til et andet ved hjælp af QueryExpressionToFetchXmlRequest meddelelsen eller FetchXmlToQueryExpressionRequest meddelelsen, ignoreres sideopdelingscookiens værdi. Hvis du desuden anmoder om ikke-sammenhængende sider, ignoreres sideopdelingscookiens værdi.

Brug en sideopdelingscookie med QueryExpression

Følgende eksempel viser, hvordan du bruger sideopdelingscookien med et forespørgselsudtryk. Se Eksempel: Brug QueryExpression med en sideopdelingscookie for at se hele eksempelkoden.

// 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;
    }
}

Se også

Oprette forespørgsler med QueryExpression
Eksempel: Brug QueryExpression med en sideopdelingscookie
Eksempel: Hente med en-til-mange-relation
Bruge klassen QueryExpression
Sideopdele store resultatsæt med FetchXML

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret