Progress.Data.BindingSource class

(Windows only; GUI for .NET only)

A BindingSource object (the ProBindingSource) that allows you to bind a .NET control on a form to one of the following ABL data source objects:

Note: Progress Software Corporation recommends that you open (or reopen) any query associated with a ProBindingSource instance using the PRESELECT option, which optimizes query performance.

The Progress.Data.BindingSource class is an OpenEdge .NET class that extends the .NET System.Windows.Forms.BindingSource class. The ProBindingSource acts as a conduit between a .NET control and an ABL data source object. A bound .NET control considers the ProBindingSource to be its data source. In turn, the ProBindingSource sets the underlaying ABL data source object as its data source. For a complete overview of data binding between .NET controls and ABL data source objects, see OpenEdge Development: GUI for .NET Programming.

Serializable:

No

Constructors

PUBLIC BindingSource ( INPUT query-hdl AS HANDLE )

PUBLIC BindingSource ( INPUT query-hdl AS HANDLE, 
                       INPUT include-fields AS CHARACTER, 
                       INPUT except-fields AS CHARACTER )

PUBLIC BindingSource ( INPUT dataset-hdl AS HANDLE )

PUBLIC BindingSource ( INPUT dataset-hdl AS HANDLE,
                     { INPUT parent-buffer-name AS CHARACTER 
                     | INPUT parent-buffer-hdl AS HANDLE } )

PUBLIC BindingSource ( INPUT dataset-hdl AS HANDLE,
                       INPUT include-fields AS CHARACTER, 
                       INPUT except-fields AS CHARACTER )

PUBLIC BindingSource ( INPUT dataset-hdl AS HANDLE,
                     { INPUT parent-buffer-name AS CHARACTER 
                     | INPUT parent-buffer-hdl AS HANDLE },
                      INPUT include-fields AS CHARACTER, 
                      INPUT except-fields AS CHARACTER )

PUBLIC BindingSource ( INPUT dataset-hdl AS HANDLE, 
                       INPUT report-mode AS LOGICAL )

PUBLIC BindingSource ( INPUT dataset-hdl AS HANDLE,
                     { INPUT parent-buffer-name AS CHARACTER 
                     | INPUT parent-buffer-hdl AS HANDLE }, 
                       INPUT include-fields AS CHARACTER, 
                       INPUT except-fields AS CHARACTER,
                       INPUT report-mode AS LOGICAL )

PUBLIC BindingSource ( INPUT buffer-hdl AS HANDLE )

PUBLIC BindingSource ( INPUT buffer-hdl AS HANDLE, 
                       INPUT include-fields AS CHARACTER, 
                       INPUT except-fields AS CHARACTER )

PUBLIC BindingSource ( )
query-hdl
A HANDLE variable that represents the handle to a query object.
dataset-hdl
A HANDLE variable that represents the handle to a ProDataSet object.
buffer-hdl
A HANDLE variable that represents the handle to a buffer object.
parent-buffer-name
A CHARACTER variable that represents the name of a parent buffer in a ProDataSet object. This corresponds to the top-level table displayed in a hierarchical control (such as a grid or a treeview).
parent-buffer-hdl
A HANDLE variable that represents the handle to a parent buffer in a ProDataSet object. This corresponds to the top-level table displayed in a hierarchical control (such as a grid or a treeview).
include-fields
An optional CHARACTER expression that evaluates to a comma-separated list of fields in the ABL data source object to bind to the ProBindingSource. To include all fields, specify an asterisk (*) in include-fields. To include all but a few fields, specify an asterisk (*) in include-fields and a comma-separated list of fields to exclude in except-fields. If include-fields contains specific fields, except-fields is ignored.

When including fields for a ProDataSet object, you must specify a comma-separated list of fields to display in display order and qualify the field names with their buffer name. For example:

"table1.field1, table1.field2, table2.field1, table1.field3"

You must specify at least one field from each table in the hierarchy to be displayed.

When including fields for a query or a join query, you must specify a comma-separated list of fields to display in display order and you should qualify ambiguous field names with their buffer name.

Do not specify a RAW temp-table or a database field in include-fields. If you explicitly specify a RAW field, the AVM generates a run-time error. If you specify an asterisk (*) to include all fields and there is a RAW field in the table, the AVM excludes it automatically even if it is not specified in except-fields.

except-fields
A CHARACTER expression that evaluates to a comma-separated list of fields in the ABL data source object to exclude from binding to the ProBindingSource. You can specify fields to exclude only when include-fields contains an asterisk (*). If you do not have any fields to exclude, you must specify the empty string (""). If include-fields contains specific fields, except-fields is ignored.
report-mode
When report-mode is set to true, it indicates that any control that binds to this ProBindingSource will be a non-graphical or reporting object. This allows the ProBindingSource to make optimizations to reduce memory usage.

Binding to a query associated with a temp-table or database table

When binding to a temp-table or database table through a query, consider the following:

Binding to a ProDataSet object

Binding to a ProDataSet object enables you to create a hierarchical display of a parent buffer and its child buffers in the same .NET control (such as a grid or a treeview). When binding to a ProDataSet object, consider the following:

Binding to a buffer object

When binding to a temp-table or database buffer, consider the following:

Binding to an unbound ProBindingSource instance

An unbound ProBindingSource instance is created by invoking the ProBindingSource constructor with no parameters. When binding to an unbound ProBindingSource instance, consider the following:

Super Class

System.Windows.Forms.BindingSource class (from the .NET Framework)

Interfaces

This class does not implement interfaces (beyond those it inherits from its base class).

Public Properties

Public Methods

Public Events

Notes