TXMLBroker.MaxRecords Property

Specifies the maximum number of records that can appear in XML data packets.

Pascal

property MaxRecords: Integer;

C++

__property int MaxRecords;

Description

Set MaxRecords to limit the size of XML data packets retrieved from the associated provider.

When MaxRecords is –1, XML data packets contain all the records in the provider's dataset.

When MaxRecords is 0, XML data packets contain only metadata.

When MaxRecords is greater than 0, XML data packets contain up to MaxRecords records, depending on the number of records in the provider's dataset.

Tip: Because an InternetExpress application sends the entire data packet to client applications, it is important to limit the size of data packets. Otherwise, the time to download web pages containing data packets can be prohibitively long.

Note: When limiting the number of records that appear in data packets, you may need to fetch several data packets before all data is returned. Because InternetExpress applications are always stateless, you will need to supply information about what record should start the next data packet as the OwnerData parameter of GetXMLRecords or RequestRecords. You can use a query form to obtain information about the last record seen by a particular Web client.