PriorityBinding クラス

リファレンス

定義

名前空間:: System.Windows.Data

アセンブリ:: PresentationFramework.dll

重要

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

1 つのバインドターゲットプロパティに関連付けられた Binding オブジェクトのコレクションを記述します。このプロパティは、コレクション内の正常に値を生成する最初のバインドからその値を受け取ります。

public ref class PriorityBinding : System::Windows::Data::BindingBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Bindings")]
public class PriorityBinding : System.Windows.Data.BindingBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Bindings")>]
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild

Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild

継承: Object

MarkupExtension

BindingBase
PriorityBinding

属性: ContentPropertyAttribute

実装: IAddChild

注釈

PriorityBinding では、バインドターゲット (ターゲット) プロパティをバインドの一覧に関連付けることができます。値を返す最初のバインディングが、アクティブなバインディングになります。

バインディングは、次の場合に値を正常に返します。

バインディングソースへのパスが正常に解決されます。
値コンバーターがある場合は、結果の値を変換できます。
結果の値は、ターゲットプロパティに対して有効です。

値 DependencyProperty.UnsetValue は成功した戻り値とは見なされません。

バインディングの優先順位は、リスト内の順序によって決まります。リストの最初に表示されるバインディングの優先度が最も高くなります。

バインドエンジンは、リスト内の最初のバインドから始まり、そのバインディングが値を正常に返すかどうかを確認します。その場合は、そのバインディングの値が使用されます。最初のバインドで値が正常に返されない場合、バインディングエンジンは 2 番目のバインディングを調べて、値が正常に返されるかどうかを判断します。その場合、2 番目のバインディングの値がアクティブな値になります。この検証プロセスは、バインドの一覧の最後まで続きます。どのバインディングも値を正常に返さない場合、バインディングはを使用します FallbackValue。

バインドエンジンは、すべてのバインディングの変更を引き続きリッスンします。優先度が高いいずれかのバインディングで値が正常に返された場合、そのバインディングの値はアクティブな値になり、現在の値が置き換えられます。

コンストラクター

PriorityBinding()

PriorityBinding クラスの新しいインスタンスを初期化します。

プロパティ

BindingGroupName	そのバインディングが属している BindingGroup の名前を取得または設定します。 (継承元 BindingBase)
Bindings	Binding のこのインスタンスで確立されている PriorityBinding オブジェクトのコレクションを取得します。
Delay	ターゲット上の値が変更された後でバインディングソースを更新する前に待機する時間 (ミリ秒単位) を取得または設定します。 (継承元 BindingBase)
FallbackValue	バインドが値を返すことができないときに使用する値を取得または設定します。 (継承元 BindingBase)
StringFormat	バインドされている値が文字列として表示される場合に、バインディングの書式を指定する文字列を取得または設定します。 (継承元 BindingBase)
TargetNullValue	ソースの値が `null` のときにターゲットで使用される値を取得または設定します。 (継承元 BindingBase)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ProvideValue(IServiceProvider)	このバインディングおよび拡張機能の適用先のプロパティに設定されるオブジェクトを返します。 (継承元 BindingBase)
ShouldSerializeBindings()	シリアル化プロセスが、このクラスのインスタンスの Bindings プロパティの有効値をシリアル化する必要があるかどうかを示す値を返します。
ShouldSerializeFallbackValue()	シリアル化プロセスが、このクラスのインスタンスの FallbackValue プロパティの有効値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 BindingBase)
ShouldSerializeTargetNullValue()	TargetNullValue プロパティをシリアル化する必要があるかどうかを示す値を返します。 (継承元 BindingBase)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

IAddChild.AddChild(Object)	このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
IAddChild.AddText(String)	このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

適用対象

次の方法で共有