DataSourceUpdateMode Enum

Definition

Specifies when a data source is updated when changes occur in the bound control.

public enum class DataSourceUpdateMode
public enum DataSourceUpdateMode
type DataSourceUpdateMode = 
Public Enum DataSourceUpdateMode
Inheritance
DataSourceUpdateMode

Fields

Never 2

Data source is never updated and values entered into the control are not parsed, validated or re-formatted.

OnPropertyChanged 1

Data source is updated whenever the value of the control property changes.

OnValidation 0

Data source is updated when the control property is validated. After validation, the value in the control property is also reformatted.

Remarks

When a control is bound to a data source using a Binding object, you can specify when an update to the data source will occur using the DataSourceUpdateMode enumeration.

When the update mode is Never, you can force the data source to be updated by using the WriteValue method.

Note

Even when the update mode is set to Never, the data source will be updated when the binding is first created, so at least one update will always occur.

Applies to