BindingMode 列舉

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

描述資料如何在系結中傳播。

public enum class BindingMode

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

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

Public Enum BindingMode

<object property="enumMemberName"/>

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

OneTime	2	建立系結時，更新目標屬性。
OneWay	1	建立系結時，更新目標屬性。來源物件的變更也可以傳播至目標。
TwoWay	3	更新變更目標或來源物件時。建立系結時，會從來源更新目標屬性。

此範例示範如何在 XAML 中設定系結模式。

<TextBox x:Name="MyTextBox" Text="Text" Foreground="{Binding Brush1, Mode=OneWay}"/>

針對 OneWay 和 TwoWay 系結，來源的動態變更不會自動傳播至目標。您必須在來源物件上實作 INotifyPropertyChanged 介面，才能發生這種情況。

若為 TwoWay 系結，則變更目標會自動傳播至來源，但系結目標為 Text 屬性除外。在此情況下，只有在 TextBox 失去焦點時，才會進行更新。

針對 OneTime 和 OneWay 系結，呼叫 DependencyObject.SetValue 會自動變更目標值並刪除系結。