From RAD Studio API Documentation
Jump to: navigation, search


function QueryEntities(const TableName: string; const FilterExpression: string = '';  ResponseInfo: TCloudResponseInfo = nil; const NextPartitionKey: string = ''; const NextRowKey: string = ''): TList<TCloudTableRow>; overload;


System::Generics::Collections::TList__1<Data::Cloud::Cloudapi::TCloudTableRow*>* __fastcall QueryEntities(const System::UnicodeString TableName, const System::UnicodeString FilterExpression = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), const System::UnicodeString NextPartitionKey = System::UnicodeString(), const System::UnicodeString NextRowKey = System::UnicodeString())/* overload */;


Type Visibility Source Unit Parent
function public
Data.Cloud.AzureAPI TAzureTableService


Returns the entities (rows) for the specified table, optionally filtering the result.

The QueryEntities method returns the table rows that match the given filter, or all rows (up to 1000 rows) if no filter is given.

At most, 1000 rows are returned. If 1000 rows are returned, use the header values for 'x-ms-continuation-NextPartitionKey' and 'x-ms-continuation-NextRowKey' to get the unique identifier of the 1001st row. To get these values, you need to use the ResponseInfo parameter. Use the unique identifier values (NextParitionKey and NextRowKey) in your next call to this function to retrieve the next batch of rows.

The TableName parameter specifies the name of the table to get the rows for.

The FilterExpression parameter is the optional filter expression for refining the results.

The ResponseInfo parameter specifies the optional class where to store response info.

The NextPartitionKey parameter is the continuation token value from 'x-ms-continuation-NextPartitionKey'.

The NextRowKey parameter is the continuation token value from 'x-ms-continuation-NextRowKey'.

Note: See the MSDN documentation on "Querying Tables and Entities" for more information on the FilterExpression parameter.

See Also