PriorityBinding 類別

定義

命名空間:

System.Windows.Data

組件:

PresentationFramework.dll

描述一組 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 讓你能將綁定目標（目標）屬性與綁定清單關聯起來。 第一個成功回傳值的綁定會成為主動綁定。

若有以下條件，則綁定成功回傳一個值：

1. 通往結合源的路徑成功解決。

2. 值轉換器（若有的話）能夠轉換所得值。

3. 所得值對目標屬性有效。

該價值 DependencyProperty.UnsetValue 不被視為成功的回報價值。

綁定的優先順序依照它們在列表中的順序決定。 列表中最先出現的綁定具有最高優先權。

綁定引擎從列表中的第一個綁定開始，並驗證該綁定是否成功回傳一個值;如果有，則會使用該綁定的值。 如果第一次綁定未能成功回傳某個值，綁定引擎會檢查第二個綁定是否成功回傳該值;如果有，第二次綁定的值就變成了主動值。 此驗證過程持續至綁定清單的最後。 若沒有任何綁定成功回傳值，則綁定會使用 。FallbackValue

綁定引擎持續監聽所有綁定的變化。 如果在某個優先順序較高的綁定中成功回傳某個值，該綁定的值將成為有效值並取代目前值。

建構函式

名稱	Description
PriorityBinding()	初始化 PriorityBinding 類別的新執行個體。

屬性

名稱	Description
BindingGroupName	取得或設定該綁定所屬的名稱 BindingGroup 。 (繼承來源 BindingBase)
Bindings	取得為該實例PriorityBinding所建立的物件集合Binding。
Delay	取得或設定在目標值改變後更新綁定來源前的等待時間（以毫秒計）。 (繼承來源 BindingBase)
FallbackValue	當綁定無法回傳某個值時，取得或設定該值要使用。 (繼承來源 BindingBase)
StringFormat	如果將綁定值顯示為字串，則會取得或設定一個字串，指定如何格式化綁定。 (繼承來源 BindingBase)
TargetNullValue	當來源值為 null時，取得或設定目標所使用的值。 (繼承來源 BindingBase)

方法

名稱	Description
Equals(Object)	判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ProvideValue(IServiceProvider)	回傳一個物件，該物件應該設在該綁定與擴充的屬性上。 (繼承來源 BindingBase)
ShouldSerializeBindings()	回傳一個值，指示序列化程序是否應該序列化該屬性在此類實例上的有效值 Bindings 。
ShouldSerializeFallbackValue()	回傳一個值，指示序列化程序是否應該序列化該屬性在此類實例上的有效值 FallbackValue 。 (繼承來源 BindingBase)
ShouldSerializeTargetNullValue()	回傳一個值，指示該屬性是否 TargetNullValue 應該被序列化。 (繼承來源 BindingBase)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

明確介面實作

名稱	Description
IAddChild.AddChild(Object)	此成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。
IAddChild.AddText(String)	此成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。

另請參閱

• PriorityBindingExpression
• IValueConverter