ProDataSet object handle

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	–	–

Methods

 

ACCEPT-CHANGES( ) method	ADD-BUFFER( ) method
ADD-PARENT-ID-RELATION( ) method	ADD-RELATION( ) method
APPLY-CALLBACK( ) method	CLEAR( ) method (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” section.

Note 

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