BindingGroup.SharesProposedValues プロパティ

定義

BindingGroup がソースにコミットされていないターゲット値を再利用するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the BindingGroup reuses target values that have not been committed to the source.

public:
 property bool SharesProposedValues { bool get(); void set(bool value); };
public bool SharesProposedValues { get; set; }
member this.SharesProposedValues : bool with get, set
Public Property SharesProposedValues As Boolean

プロパティ値

Boolean

BindingGroup がソースにコミットされていないターゲット値を再利用する場合は true。それ以外の場合は falsetrue if the BindingGroup reuses target values that have not been committed to the source; otherwise, false. 既定では、 falseです。The default is false.

注釈

提案された値は、バインディングのターゲットで変更されたがソースにコミットされていない値です。A proposed value is a value that has been changed on the target of a binding, but has not been committed to the source. たとえば、に双方向のバインディングがあり、 TextBox UpdateSourceTrigger プロパティがに設定されているとし Explicit ます。For example, suppose that there is a two-way binding on a TextBox and the UpdateSourceTrigger property is set to Explicit. ユーザーがの値を変更した場合、提案された TextBox 値は、 TextBox ソースにコミットされる前の内の値です。If the user changes the value of the TextBox, the proposed value is the value that is in the TextBox before it is committed to source.

がの場合 SharesProposedValues true 、は、 BindingGroup 1 つのバインドが bindinggroup を離れるときに、指定された値を使用します。同じソースを持つ別のバインドが bindinggroup に参加します。When SharesProposedValues is true, the BindingGroup uses the proposed value when one binding leaves the BindingGroup and another Binding with the same source joins the BindingGroup. たとえば、アプリケーションが複数のフィールドを編集し、ボタンをクリックしてソースオブジェクトを更新できるようにするとします。For example, suppose that an application enables a user to edit multiple fields and update the source object by clicking a button. フィールドが編集されていない場合は、アプリケーションによってフィールドがに表示され TextBlock ます。When a field is not being edited, the application displays it in a TextBlock. ユーザーがフィールドの編集を開始すると、アプリケーションはをに置き換え TextBlock TextBox ます。When the user begins to edit a field, the application replaces the TextBlock with a TextBox. ユーザーがそのフィールドの編集を完了すると、アプリケーションはをに置き換え TextBox TextBlock ます。When the user finishes editing that field, the application replaces the TextBox with a TextBlock. ソースは、ユーザーがボタンをクリックするまで更新されないため、が提案された値を表示するための方法が必要 TextBlock です。Because the source is not updated until the user clicks the button, there must be a way for the TextBlock to display the proposed value. SharesProposedValuesをに設定すると、 true ソースが更新されていない場合でも、アプリケーションによってフィールドに対するユーザーの変更が表示されます。By setting SharesProposedValues to true, the application will display the user's changes to a field even when the source has not been updated.

適用対象