DataSourceUpdateMode Enumeration (System.Windows.Forms)

Switch View

DataSourceUpdateMode Enumeration

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

DataSourceUpdateMode Enumeration

Updated: October 2008

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic (Declaration)

Public Enumeration DataSourceUpdateMode

Visual Basic (Usage)

Dim instance As DataSourceUpdateMode

public enum DataSourceUpdateMode

Visual C++

public enum class DataSourceUpdateMode

JScript

public enum DataSourceUpdateMode

Members

	Member name	Description
	OnValidation	Data source is updated when the control property is validated, After validation, the value in the control property will also be re-formatted.
	OnPropertyChanged	Data source is updated whenever the value of the control property changes.
	Never	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 that at least one update will always occur.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

.NET Compact Framework

Supported in: 3.5, 2.0

Reference

System.Windows.Forms Namespace

Change History

Date	History	Reason
October 2008	Added note in Remarks section.	Customer feedback.

Date

History

Reason

October 2008

Added note in Remarks section.

Customer feedback.