Binding.UpdateSourceTrigger Binding.UpdateSourceTrigger Binding.UpdateSourceTrigger Binding.UpdateSourceTrigger Property


バインディング ソースの更新のタイミングを決定する値を取得または設定します。Gets or sets a value that determines the timing of binding source updates.

 property System::Windows::Data::UpdateSourceTrigger UpdateSourceTrigger { System::Windows::Data::UpdateSourceTrigger get(); void set(System::Windows::Data::UpdateSourceTrigger value); };
public System.Windows.Data.UpdateSourceTrigger UpdateSourceTrigger { get; set; }
member this.UpdateSourceTrigger : System.Windows.Data.UpdateSourceTrigger with get, set
Public Property UpdateSourceTrigger As UpdateSourceTrigger


UpdateSourceTrigger 値のいずれか。One of the UpdateSourceTrigger values. 既定値は Default で、ターゲット依存関係プロパティの既定の UpdateSourceTrigger 値を返します。The default is Default, which returns the default UpdateSourceTrigger value of the target dependency property. ほとんどの依存関係プロパティの既定値は PropertyChanged です。ただし、Text プロパティの既定値は LostFocus です。However, the default value for most dependency properties is PropertyChanged, while the Text property has a default value of LostFocus.

プログラムを使って依存関係プロパティの既定の UpdateSourceTrigger 値を確認するには、GetMetadata(Type) を使ってプロパティのプロパティ メタデータを取得してから、DefaultUpdateSourceTrigger プロパティの値を確認します。A programmatic way to determine the default UpdateSourceTrigger value of a dependency property is to get the property metadata of the property using GetMetadata(Type) and then check the value of the DefaultUpdateSourceTrigger property.


バインドTwoWayまたはOneWayToSourceターゲット プロパティの変更をリッスンし、それらを元に伝達します。Bindings that are TwoWay or OneWayToSource listen for changes in the target property and propagate them back to the source. これは、ソースの更新と呼ばれます。This is known as updating the source. 通常、これらの更新プログラムは、ターゲット プロパティが変更されるたびに発生します。Usually, these updates happen whenever the target property changes. これには、チェック ボックスおよびその他の単純なコントロールの問題が、テキスト フィールドに適切でない、通常は。This is fine for check boxes and other simple controls, but it is usually not appropriate for text fields. パフォーマンスの低下やキーストロークのたびに、backspace キーし、新しい値をコミットする前に入力ミスを修正する通常の営業案件をユーザーが拒否した後に更新しています。Updating after every keystroke can diminish performance and it denies the user the usual opportunity to backspace and fix typing errors before committing to the new value. 既定ではそのため、UpdateSourceTriggerの値、TextプロパティはLostFocusなくPropertyChangedします。Therefore, the default UpdateSourceTrigger value of the Text property is LostFocus and not PropertyChanged.

設定した場合、UpdateSourceTrigger値をExplicit、呼び出す必要があります、UpdateSourceメソッドまたは変更がソースに反映されません。If you set the UpdateSourceTrigger value to Explicit, you must call the UpdateSource method or the changes will not propagate back to the source.