BindingGroup.SharesProposedValues Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy BindingGroup ponownie używa wartości docelowej, które nie zostały przekazane do źródła.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

Wartość właściwości

trueJeśli ponownie używa wartości docelowych, które nie zostały przekazane do źródła; falsew przeciwnym razie. BindingGrouptrue if the BindingGroup reuses target values that have not been committed to the source; otherwise, false. Wartość domyślna to false.The default is false.

Uwagi

Proponowana wartość jest wartością, która została zmieniona w elemencie docelowym powiązania, ale nie została zatwierdzona do źródła.A proposed value is a value that has been changed on the target of a binding, but has not been committed to the source. Załóżmy na przykład, że istnieje dwukierunkowe powiązanie w TextBox UpdateSourceTrigger i właściwość jest ustawiona na Explicit.For example, suppose that there is a two-way binding on a TextBox and the UpdateSourceTrigger property is set to Explicit. Jeśli użytkownik zmieni wartość TextBox, proponowana wartość jest wartością znajdującą się TextBox w przed zatwierdzeniem do źródła.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.

Gdy SharesProposedValues BindingGroup ma truewartość, używa proponowanej wartości, gdy jedno powiązanie opuszcza, a inne powiązanie z tym samym źródłem sprzężeń.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. Załóżmy na przykład, że aplikacja umożliwia użytkownikowi edytowanie wielu pól i aktualizowanie obiektu źródłowego przez kliknięcie przycisku.For example, suppose that an application enables a user to edit multiple fields and update the source object by clicking a button. Gdy pole nie jest edytowane, aplikacja wyświetli go w TextBlock.When a field is not being edited, the application displays it in a TextBlock. Gdy użytkownik zacznie edytować pole, aplikacja zastępuje TextBlock. TextBoxWhen the user begins to edit a field, the application replaces the TextBlock with a TextBox. Gdy użytkownik zakończy edytowanie tego pola, aplikacja zastępuje TextBox. TextBlockWhen the user finishes editing that field, the application replaces the TextBox with a TextBlock. Ponieważ źródło nie jest aktualizowane do momentu kliknięcia przycisku przez użytkownika, w TextBlock celu wyświetlenia proponowanej wartości musi istnieć sposób.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. Po ustawieniu SharesProposedValues na true, aplikacja będzie wyświetlać zmiany w polu użytkownika, nawet jeśli źródło nie zostało zaktualizowane.By setting SharesProposedValues to true, the application will display the user's changes to a field even when the source has not been updated.

Dotyczy