AppExchange logo

queryMore


Retrieves the next batch of objects from a query.

Syntax

QueryResult = sfdc.queryMore(QueryLocator QueryLocator); 

Usage

You use queryMore to process query calls that retrieve a large number of records (by default, more than 500) in the result set. The query call retrieves the first 500 records and creates a server-side cursor that is represented in the queryLocator object. The queryMore call processes subsequent records in up to 500-record chunks, resets the server-side cursor, and returns a newly generated QueryLocator. To iterate through records in the result set, you generally call queryMore repeatedly until all records in the result set have been processed (the Done flag is True). You can change the maximum number of records returned to up to 2,000. See Changing the Batch Size in Queries for more information.

Sample Code-Java

See the Sample Code-Java for the query call.

Sample Code-C#

See the Sample Code-C# for the query call.

Arguments

Name
Type
Description
queryLocator
Represents the server-side cursor that tracks the current processing location in the query result set.

Response

QueryResult

Faults

InvalidQueryLocatorFault

UnexpectedErrorFault

See Also

query

Using API Calls

Changing the Batch Size in Queries

Sample SOAP Messages - queryMore


© Copyright 2000-2006 salesforce.com, inc.
All rights reserved • Various trademarks held by their respective owners.
Have feedback about this page? Click the red email icon in the top right corner to contact us.