Binding クラス

リファレンス

定義

名前空間:: System.Windows.Data

アセンブリ:: PresentationFramework.dll

重要

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

バインドの定義に高レベルでアクセスします。バインドは、バインドターゲットオブジェクト (通常は、WPF 要素) のプロパティと任意のデータソース (データベース、XML ファイル、データを格納している任意のオブジェクトなど) とを接続します。

public ref class Binding : System::Windows::Data::BindingBase

public class Binding : System.Windows.Data.BindingBase

type Binding = class
    inherit BindingBase

Public Class Binding
Inherits BindingBase

継承: Object

MarkupExtension

BindingBase
Binding

注釈

Windows Presentation Foundation (WPF) のデータバインディングによって、アプリケーションでデータの表示とやりとりを行うための、シンプルかつ一貫した方法が提供されます。データバインディングを使用すると、2 つの異なるオブジェクトのプロパティの値を同期できます。

バインディングを確立するには、クラスまたはを Binding 継承 BindingBaseする他のクラスのいずれかを使用します。バインドするオブジェクトとデータソースの性質に関係なく、各バインドは次の図に示すモデルに従います。

基本的なデータバインディング図

この図は、次の基本的な WPF データバインディングの概念を示しています。

通常、各バインドには、バインドターゲットオブジェクト、ターゲットプロパティ、バインドソース、および Path 使用するバインディングソース内の値に対するという 4 つのコンポーネントがあります。たとえば、の内容を Employee オブジェクトの TextBox Name プロパティにバインドする場合、ターゲットオブジェクトはであり TextBox、ターゲットプロパティは Text プロパティ、使用する値は Name、ソースオブジェクトは Employee オブジェクトです。
ターゲットプロパティは、依存関係プロパティである必要があります。これは、フィールドをバインドできないことも意味します。オブジェクトの UIElement ほとんどのプロパティは依存関係プロパティであり、読み取り専用プロパティを除くほとんどの依存関係プロパティは、既定でデータバインディングをサポートします。 (依存関係プロパティを定義できるのは型のみで DependencyObject 、すべての UIElement オブジェクトはから DependencyObject派生します)。
図では指定されていませんが、バインディングソースオブジェクトがカスタム CLR オブジェクトであることに制限されないことに注意してください。 WPF データバインディングでは、CLR オブジェクトと XML の形式のデータがサポートされます。いくつかの例を示すために、バインディングソースにはUIElement、、任意のリストオブジェクト、ADO.NET データまたは Web サービスに関連付けられている CLR オブジェクト、または XML データを含む XmlNode を指定できます。

プロパティを Mode 使用して、データフローの方向を指定します。一方向または双方向のバインドでソースの変更を検出するには、ソースでなどの INotifyPropertyChanged適切なプロパティ変更通知メカニズムを実装する必要があります。例については、「方法: プロパティ変更通知を実装する」を参照してください。プロパティは UpdateSourceTrigger 、ソース更新のタイミングを指定します。詳細については、「データバインディングの概要」の「基本的なデータバインディングの概念」を参照してください。

XAML 属性の使用方法

<object property="{Binding  declaration}"/>

XAML 値

declaration
コンマ (,) で区切られた 0 個以上の属性代入句。詳細については、「バインディングマークアップ拡張機能」または「バインド宣言の概要」を参照してください。

コンストラクター

Binding()	Binding クラスの新しいインスタンスを初期化します。
Binding(String)	初期化パスを使用して、Binding クラスの新しいインスタンスを初期化します。

フィールド

DoNothing	アクションを実行しないようにバインドエンジンに指示するために、戻り値として使用されます。
IndexerName	PropertyName の PropertyChangedEventArgs として使用され、インデクサープロパティが変更されたことを示します。
SourceUpdatedEvent	SourceUpdated 添付イベントを識別します。
TargetUpdatedEvent	TargetUpdated 添付イベントを識別します。
XmlNamespaceManagerProperty	XmlNamespaceManager 添付プロパティを識別します。

プロパティ

AsyncState	非同期データディスパッチャーに渡される非透過データを取得または設定します。
BindingGroupName	そのバインディングが属している BindingGroup の名前を取得または設定します。 (継承元 BindingBase)
BindsDirectlyToSource	Path を評価するときに、データ項目を基準にするか、DataSourceProvider オブジェクトを基準にするかを示す値を取得または設定します。
Converter	使用するコンバーターを取得または設定します。
ConverterCulture	コンバーターを評価するカルチャを取得または設定します。
ConverterParameter	Converter に渡すパラメーターを取得または設定します。
Delay	ターゲット上の値が変更された後でバインディングソースを更新する前に待機する時間 (ミリ秒単位) を取得または設定します。 (継承元 BindingBase)
ElementName	バインドソースオブジェクトとして使用する要素の名前を取得または設定します。
FallbackValue	バインドが値を返すことができないときに使用する値を取得または設定します。 (継承元 BindingBase)
IsAsync	Binding が値の取得と設定を非同期で行う必要があるかどうかを示す値を取得または設定します。
Mode	バインドのデータフローの方向を示す値を取得または設定します。
NotifyOnSourceUpdated	バインディングターゲットからバインディングソースへ値が転送されたときに、SourceUpdated イベントを発生させるかどうかを示す値を取得または設定します。
NotifyOnTargetUpdated	バインディングソースからバインディングターゲットへ値が転送されたときに TargetUpdated イベントを発生させるかどうかを示す値を取得または設定します。
NotifyOnValidationError	バインドされたオブジェクトに対して Error 添付イベントを発生させるかどうかを示す値を取得または設定します。
Path	バインディングソースプロパティへのパスを取得または設定します。
RelativeSource	バインディングターゲットの位置に対して相対的な位置を指定することにより、バインディングソースを取得または設定します。
Source	バインドソースとして使用されるオブジェクトを取得または設定します。
StringFormat	バインドされている値が文字列として表示される場合に、バインディングの書式を指定する文字列を取得または設定します。 (継承元 BindingBase)
TargetNullValue	ソースの値が `null` のときにターゲットで使用される値を取得または設定します。 (継承元 BindingBase)
UpdateSourceExceptionFilter	バインディングソースの値の更新時にバインディングエンジンが検出した例外を処理するためにカスタムロジックの提供に使用できるハンドラーを取得または設定します。これは、バインディングに ExceptionValidationRule を関連付けている場合にのみ適用できます。
UpdateSourceTrigger	バインディングソースの更新のタイミングを決定する値を取得または設定します。
ValidatesOnDataErrors	DataErrorValidationRule を含めるかどうかを示す値を取得または設定します。
ValidatesOnExceptions	ExceptionValidationRule を含めるかどうかを示す値を取得または設定します。
ValidatesOnNotifyDataErrors	NotifyDataErrorValidationRule を含めるかどうかを示す値を取得または設定します。
ValidationRules	ユーザー入力の有効性をチェックする規則のコレクションを取得します。
XPath	使用する `XPath` XML バインディングソースの値を返すクエリを取得または設定します。

添付プロパティ

XmlNamespaceManager

XML バインディングで名前空間に対応している XPath クエリを実行するために使用される XmlNamespaceManager を取得または設定します。

メソッド

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	SourceUpdated 添付イベントのハンドラーを追加します。
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	TargetUpdated 添付イベントのハンドラーを追加します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetXmlNamespaceManager(DependencyObject)	指定したオブジェクトにアタッチされているバインドによって使用される XML 名前空間マネージャーオブジェクトを返します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ProvideValue(IServiceProvider)	このバインディングおよび拡張機能の適用先のプロパティに設定されるオブジェクトを返します。 (継承元 BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	SourceUpdated 添付イベントのハンドラーを削除します。
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	TargetUpdated 添付イベントのハンドラーを削除します。
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	指定した要素にアタッチされているバインドによって使用される名前空間マネージャーオブジェクトを設定します。
ShouldSerializeFallbackValue()	シリアル化プロセスが、このクラスのインスタンスの FallbackValue プロパティの有効値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 BindingBase)
ShouldSerializePath()	Path プロパティを永続化する必要があるかどうかを示します。
ShouldSerializeSource()	Source プロパティを永続化する必要があるかどうかを示します。
ShouldSerializeTargetNullValue()	TargetNullValue プロパティをシリアル化する必要があるかどうかを示す値を返します。 (継承元 BindingBase)
ShouldSerializeValidationRules()	ValidationRules プロパティを永続化する必要があるかどうかを示します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

添付イベント

SourceUpdated	値がバインディングターゲットからバインディングソースに転送されるときに発生します。ただし、これは NotifyOnSourceUpdated 値が `true` に設定されているバインディングに限られます。
TargetUpdated	値がバインディングソースからバインディングターゲットに転送されるときに発生します。ただし、これは NotifyOnTargetUpdated 値が `true` に設定されているバインディングに限られます。

適用対象

次の方法で共有