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 Access .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 you 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 you 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 you 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 you 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 you 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 you 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.

MapNullToEmptyString Buffer, query, ProDataSet R/W

LOGICAL

Indicates whether the BindingSource returns the Unknown (?) value or an empty string when the value in the .NET object is null. If MapNullToEmptyString is set to TRUE, then the empty string is returned; if set to FALSE, then the Unknown (?) value is returned.
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 (?).
UseFullFieldNames Buffer, query R/W

LOGICAL

Allows you to display duplicate fields names from different tables when bound to a joined query.
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.