Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## 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 | TYPE attribute
> UNIQUE-ID attribute |  |

> #### Methods

> ACCEPT-CHANGES( ) method | ADD-BUFFER( ) method
> ADD-RELATION( ) method | APPLY-CALLBACK( ) method
> CLEAR( ) method | 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-XML( ) method
> READ-XMLSCHEMA( ) method | REJECT-CHANGES( ) method
> SET-BUFFERS( ) method | SET-CALLBACK( ) method
> SET-CALLBACK-PROCEDURE( ) 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

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095