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

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation