TCustomClientDataSet.DataSetField Property

Indicates the TDataSetField component that represents this client dataset.

Pascal

property DataSetField: TDataSetField;

C++

__property TDataSetField DataSetField;

Description

Use DataSetField when the client dataset is the nested detail set of another (master) client dataset. Read DataSetField to access the data set field component in the master dataset that comprises this client dataset. Set DataSetField to a field component in the master dataset to assign this client dataset as the value of that field component.

When setting DataSetField, the ProviderName, RemoteServer, and FileName properties of the client dataset are cleared. This is because the client dataset's data is now maintained by the master table in which it is nested.

Note: The master dataset that includes the TDataSetField component must be another client dataset. Otherwise, setting DataSetField raises an exception. Further, setting DataSetField to a TDataSetField that is contained in the same client dataset leads to an exception (A dataset can't be nested in itself).