UpdateSourceTrigger Enum

Reference

Definition

Namespace:: Windows.UI.Xaml.Data

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.

Edit

Defines constants that indicate when a binding source is updated by its binding target in two-way binding.

public enum class UpdateSourceTrigger

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class UpdateSourceTrigger

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum UpdateSourceTrigger

Public Enum UpdateSourceTrigger

Inheritance: Enum
UpdateSourceTrigger

Attributes: ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

Name	Value	Description
Default	0	Use default behavior from the dependency property that uses the binding.
PropertyChanged	1	The binding source is updated whenever the binding target value changes. This is detected automatically by the binding system.
Explicit	2	The binding source is updated only when you call the BindingExpression.UpdateSource method. (Not supported for `x:Bind`.)
LostFocus	3	The binding source is updated whenever the binding target element loses focus.

Remarks

Note

The default UpdateSourceTrigger value is Default rather than PropertyChanged for legacy reasons. This evaluates as a PropertyChanged update behavior for most dependency properties, but evaluates as LostFocus for the TextBox.Text property.

Version history

Windows version	SDK version	Value added
1709	16299	LostFocus

Applies to

Product	Versions
WinRT	Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Share via