TDataSet.GetFieldList Method

Retrieves a specified set of field objects into a list.

Pascal

procedure GetFieldList(List: TList; const FieldNames: WideString);

C++

__fastcall GetFieldList(TList List, const BSTR FieldNames);

Description

Call GetFieldList to copy a specified set of field objects into a list object created and maintained by the application.

List is the TList object into which to copy the field objects. FieldNames is a string containing the name of the fields to copy. Each field name in the string must be separated from other field names with a semicolon. GetFieldList builds a list that contains only the field objects for which it finds a matching name in the dataset's list of field objects.

Note: Applications do not normally call GetFieldList to copy field objects. Field objects are directly accessible through the dataset itself. In some cases, however, it can be useful to work with a copy of a field object or its data instead of working on the actual object in the dataset.