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

Properties

The ProBindingSource provides properties to handle binding to the various ABL data source objects. The following table lists these extended properties. For more information about indexed properties, see Accessing .NET indexed properties and collections.
Property
Data source objects
Access and Type
Description
AllowEdit
Buffer, query, ProDataSet
R/W
LOGICAL
Indicates whether the .NET control should allow the user to edit values in the bound ABL data source object. The default value is TRUE.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control. Use ChildAllowEdit to enable editing for child tables.
AllowNew
Query, ProDataSet
R/W
LOGICAL
Indicates whether the .NET control should allow the user to add new records to the bound ABL data source object. The default value is TRUE.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control. Use ChildAllowNew to enable adding for child tables.
AllowRemove
Query, ProDataSet
R/W
LOGICAL
Indicates whether the .NET control should allow the user to remove records from the bound ABL data source object. The default value is TRUE.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control. Use ChildAllowRemove to enable removing for child tables.
AutoSort
Query, ProDataSet
R/W
LOGICAL
Indicates whether the ProBindingSource object automatically resorts records in the ABL data source object in response to appropriate user actions in the bound .NET control. The default value is FALSE.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control.
AutoSync
Buffer, query, ProDataSet
R/W
LOGICAL
Indicates whether the ProBindingSource object automatically synchronizes (refreshes) all data displayed in any bound .NET control after one of the following ABL operations on the bound ABL data source object:
*Reopening the query associated with the data source
*Repositioning the query associated with the data source using either the REPOSITION statement or any of the REPOSITION methods
The default value is TRUE.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control.
AutoUpdate
Buffer, query, ProDataSet
R/W
LOGICAL
Indicates whether the ProBindingSource object automatically updates records in the ABL data source object in response to appropriate user actions in the bound .NET control. The default value is FALSE.
Note: Intended only for rapid prototyping purposes.
Batching
Query, ProDataSet
R/W
LOGICAL
Indicates whether record batching is enabled for the ProBindingSource object. The default value is FALSE, which disables record batching.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control.
ChildAllowEdit[ buffer-handle | buffer-name ]
ProDataSet
R/W
LOGICAL
An indexed property that indicates whether the .NET control should allow the user to edit values in a specified child temp-table buffer in the bound ABL data source object. The default value is TRUE.
ChildAllowNew[ buffer-handle | buffer-name ]
ProDataSet
R/WLOGICAL
An indexed property that indicates whether the .NET control should allow the user to add new records to the specified child temp-table buffer in the bound ABL data source object. The default value is TRUE.
ChildAllowRemove[ buffer-handle | buffer-name ]
ProDataSet
R/WLOGICAL
An indexed property that indicates whether the .NET control should allow the user to remove records from the specified child temp-table buffer in the bound ABL data source object. The default value is TRUE.
ChildInputValue[ buffer-handle | buffer-name ]
ProDataSet
Read-only
Progress.Data.​InputValue
Returns a Progress.Data.InputValue instance containing input values for all fields in the current row of the specified child temp-table displayed in the bound .NET control. Use the indexers in this instance to access the input value of a specific field in the row.
Count
Buffer, query, ProDataSet
Read-only
INTEGER
The number of records in the result set for the query associated with the top-level table displayed in the bound .NET control.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control.
Handle
Buffer, query, ProDataSet
R/W
HANDLE
The handle to the ABL data source object to which the ProBindingSource object is bound.
You can use this property to associate an ABL data source object with an unbound ProBindingSource instance at run time.
InputValue[ field-index | field-name ] Keywords:
Buffer, query, ProDataSet
Read-only
<same as field>
Returns the input value of the specified field in the current row of the top-level table displayed in the bound .NET control.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control.
MaxDataGuess
Query, ProDataSet
R/W
INTEGER
An estimate of the number of records that a query returns.
NewRow
Query, ProDataSet
Read-only
LOGICAL
Indicates whether the current row in the bound .NET control is a newly created row that can still be undone.
When bound to a ProDataSet object, this property applies only to the top-level table displayed in the .NET control.
NoLOBs
Buffer, query, ProDataSet
R/W
LOGICAL
Specifies whether or not the AVM ignores BLOB or CLOB fields while executing the Assign( ) method or the CURRENT-CHANGED function.
Position
Buffer, query, ProDataSet
R/W
INTEGER
The zero-based position (index) of the current row in the bound .NET control.
RowModified
Buffer, query, ProDataSet
Read-only
LOGICAL
Indicates whether the current row in the bound .NET control is currently being edited.
TableSchema
Buffer, query, ProDataSet
R/W
Progress.Data.​TableDesc
Intended for design time use only. Allows code generated by the Progress Developer Studio for OpenEdge's Visual to specify schema at design time.
Tag
Buffer, query, ProDataSet
R/W
System.Object
An arbitrary user-defined object containing any information or data that you want for the ProBindingSource object. The default is Unknown value (?).
Note: A particular bound UI control might not support a particular ProBindingSource property. By the standard .NET protocol, the bound UI control reads the properties that it supports and adjusts its behavior to match. For example, a Microsoft System.Windows.Forms.TextBox does not support record deletion. Even when linked to a ProBindingSource that has AllowRemove set to TRUE, you cannot use the TextBox for record deletion.
* AutoUpdate and rapid prototyping