Try OpenEdge Now
skip to main content
GUI for .NET Programming
Binding ABL Data to .NET Controls : Understanding the ProBindingSource : Methods
 

Methods

The ProBindingSource provides several extended methods to handle binding to the various ABL data source objects. The following table lists these extended methods.
Method
Returns
Description
Assign( )
LOGICAL
Assigns input values from the current record in the bound UI control to the corresponding record in the bound ABL data source object.
Dispose( )
VOID
Cleans up ProDataSet resources held by a ProBindingSource object while awaiting .NET garbage collection. If the ProBindingSource binds a ProDataSet, call this method before releasing it for garbage collection.
Refresh( [ INPUT record-index AS INTEGER ] )
VOID
Refreshes the displayed field values for the specified record in all bound UI controls with the values in the bound ABL data source object.
When used with a bound ProDataSet, this method applies to only the top-level table.
RefreshAll( )
VOID
Refreshes the field values displayed for all rows (parent and child) in any bound .NET control with the values from the corresponding records in the bound ABL data source object.
SetFields( INPUT include-fields AS CHARACTER, INPUT except-fields AS CHARACTER, {""|INPUT parent-buffer-hdl AS HANDLE |INPUT parent-buffer-name AS CHARACTER} )
VOID
Specifies the fields that an unbound ProBindingSource should expose from whatever data source object binds to it. The final parameter can be an empty string (""), a buffer handle, or a buffer name.
Note: You must use this method before the ProBindingSource binds to the data source object. Using the method after binding the data source object cause the ProBindingSource to throw a .NET exception.