BindingMode 列挙型

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

データがバインドでどのように伝達されるかについて説明します。

public enum class BindingMode

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
enum class BindingMode

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public enum BindingMode

Public Enum BindingMode

<object property="enumMemberName"/>

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 バインドの場合、SetValue の呼び出しによってターゲット値が自動的に変更され、バインドが削除されます。