.NET Binding Declaration Properties (Magic xpa 3.x)
To bind data to a .NET object, you must first define a .NET control model with the following properties.
|
Property
|
Description
|
Mobile Support
|
|
Value Property Name
|
The name of the .NET control property that gets or sets the data, such as Value or Text.
If this property is defined, then the Value Changed Event Name is also required.
|
|
|
Value Changed Event Name
|
The name of the .NET control event that is raised when the value property is changed.
This property is required if a Value Property Name is defined.
|
|
After these properties are defined, you can assign a variable to the Data property of the .NET control. The data binding is two directional. An update of the variable value will update the control's property and vice versa.
If you updated the Magic xpa variable with the control value, but the values are different, the control will be updated with the Magic xpa variable value. Since version: 2.3
Note: These properties are defined in the .NET control model and appear as read only in the .NET control properties.
Since version: 2.1
|
Property
|
Description
|
|
DataSource Property Name
|
The name of the .NET control property that gets the Magic xpa item list or ranged data source.
This property is enabled if the Object Type property has a value.
The .NET property must be of a type that can be assignable from a DataTable.
|
|
DisplayMember Property Name
|
The name of the .NET control property that defines the column to display.
If the DataSource Property Name property has a value, this property is enabled and must also have a value.
|
|
ValueMember Property Name
|
The name of the .NET control property that defines the column that has the data value.
If the DataSource Property Name property has a value, this property is enabled and must also have a value.
|
After these properties are defined, you can assign an item list or a data source to the .NET control. The data binding is one directional; The data is sent from Magic xpa to the control when it is loaded and will not be sent again if the data is changed. Any modifications to the data in the .NET control will not be sent back to Magic xpa.
Note: These properties are defined in the .NET control model and do not appear in the .NET control properties.
Since version: 2.3
