A handle to a ProDataSet object. A ProDataSet object is a collection of one or more related temp-tables. Each temp-table in a ProDataSet object can attach to a data-source object that allows filling of the temp-table from the data source, or updating the data source from the temp-table. A ProDataSet object can optionally contain a set of data relations between the temp-tables.

A ProDataSet object can be static or dynamic. A static ProDataSet object is one you define at compile time with the DEFINE DATASET statement. A dynamic ProDataSet object is one you create at run time with the CREATE DATASET statement. Use this handle to access the ProDataSet object's attributes and methods, and its sub-elements (its temp-table buffers, data relations, data sources, and so on) and their attributes and methods.

Syntax

dataset-object-handle [ :attribute | :method ]
dataset-object-handle
An item of type HANDLE representing a handle to a ProDataSet object.
attribute
An attribute of the ProDataSet object.
method
A method of the ProDataSet object.

Attributes

ADM-DATA attribute DATA-SOURCE-MODIFIED attribute DYNAMIC attribute
ERROR attribute HANDLE attribute INSTANTIATING-PROCEDURE attribute
NAME attribute NAMESPACE-PREFIX attribute NAMESPACE-URI attribute
NEXT-SIBLING attribute NUM-BUFFERS attribute NUM-REFERENCES attribute
NUM-RELATIONS attribute NUM-TOP-BUFFERS attribute PRIVATE-DATA attribute
REJECTED attribute RELATIONS-ACTIVE attribute SERIALIZE-NAME attribute
TOP-NAV-QUERY attribute TYPE attribute UNIQUE-ID attribute
XML-NODE-NAME attribute XML-NODE-TYPE attribute –

Methods

ACCEPT-CHANGES( ) method ADD-BUFFER( ) method
ADD-PARENT-ID-RELATION( ) method ADD-RELATION( ) method
APPLY-CALLBACK( ) method CLEAR( ) method (ProDataSet Object Handle)
COPY-DATASET( ) method COPY-TEMP-TABLE( ) method
CREATE-LIKE( ) method EMPTY-DATASET( ) method
FILL( ) method GET-BUFFER-HANDLE( ) method
GET-CALLBACK-PROC-CONTEXT( ) method GET-CALLBACK-PROC-NAME( ) method
GET-CHANGES( ) method GET-RELATION( ) method
GET-TOP-BUFFER( ) method MERGE-CHANGES( ) method
READ-JSON( ) method READ-XML( ) method
READ-XMLSCHEMA( ) method REJECT-CHANGES( ) method
SET-BUFFERS( ) method SET-CALLBACK( ) method
SET-CALLBACK-PROCEDURE( ) method WRITE-JSON( ) method
WRITE-XML( ) method WRITE-XMLSCHEMA( ) method

Events

AFTER-FILL event BEFORE-FILL event

For information on these FILL events, see the ProDataSet events.

Notes

For information about dynamically accessing the data in a ProDataSet object, see the reference entries related to the TEMP-TABLE, BUFFER, BUFFER-FIELD, and QUERY objects.

See also

Buffer object handle, CREATE DATASET statement, DEFINE DATASET statement, EMPTY-TEMP-TABLE( ) method, Temp-table object handle