DataSourceUpdateMode Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
Fields
Name | Value | Description |
---|---|---|
OnValidation | 0 | Data source is updated when the control property is validated. After validation, the value in the control property is also reformatted. |
OnPropertyChanged | 1 | Data source is updated whenever the value of the control property changes. |
Never | 2 | Data source is never updated and values entered into the control are not parsed, validated or re-formatted. |
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.