MultiBinding 類別

定義

命名空間:

System.Windows.Data

組件:

PresentationFramework.dll

描述一組 Binding 附著於單一綁定目標屬性的物件。

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

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

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

Public Class MultiBinding
Inherits BindingBase
Implements IAddChild

繼承

Object

MarkupExtension

BindingBase

MultiBinding

屬性

ContentPropertyAttribute

實作

IAddChild

備註

你可以在一個 MultiBinding 物件中指定多個綁定。 當你用轉換器使用 MultiBinding 物件時，它會根據這些綁定的值產生綁定目標的最終值。 例如，顏色可能從紅色、藍色和綠色的值計算，這些值可以來自相同或不同的綁定來源物件。 當值從目標轉移到來源時，目標屬性值會被轉換成一組數值，這些值會回饋到綁定中。

和UpdateSourceTrigger屬性的Mode值決定了 和 的功能MultiBinding，除非有單一綁定覆蓋這些屬性，否則會作為集合中所有綁定的預設值。 例如，如果 Mode 物件上的 MultiBinding 屬性設定為 TwoWay，則集合中的所有綁定都會被考慮 TwoWay ，除非你明確在其中一個綁定上設定不同的 Mode 值。 欲了解更多資訊，請參閱與Binding.UpdateSourceTrigger屬性相關條目Binding.Mode。

MultiBinding 目前僅支援型別 Binding 為 的物件，不 MultiBinding 支援 或 PriorityBinding。

建構函式

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

屬性

名稱	Description
BindingGroupName	取得或設定該綁定所屬的名稱 BindingGroup 。 (繼承來源 BindingBase)
Bindings	取得此MultiBinding實例內的Binding物件集合。
Converter	取得或設定轉換器，用來將來源值轉換成目標值或轉換目標值。
ConverterCulture	取得或設定 CultureInfo 適用於任何被 MultiBinding 或 包裹在 MultiBinding 自身綁定上的轉換器物件。
ConverterParameter	取得或設定一個可選參數，作為附加資訊傳遞給轉換器。
Delay	取得或設定在目標值改變後更新綁定來源前的等待時間（以毫秒計）。 (繼承來源 BindingBase)
FallbackValue	當綁定無法回傳某個值時，取得或設定該值要使用。 (繼承來源 BindingBase)
Mode	取得或設定一個值，指示此綁定資料流的方向。
NotifyOnSourceUpdated	取得或設定一個值，指示當值從綁定目標轉移到綁定來源時是否要觸發事件 SourceUpdated 。
NotifyOnTargetUpdated	取得或設定一個值，指示當值從綁定來源轉移到綁定目標時，是否要提出 TargetUpdated 事件。
NotifyOnValidationError	取得或設定一個值，指示是否要在綁定元素上引發 Error 附加事件。
StringFormat	如果將綁定值顯示為字串，則會取得或設定一個字串，指定如何格式化綁定。 (繼承來源 BindingBase)
TargetNullValue	當來源值為 null時，取得或設定目標所使用的值。 (繼承來源 BindingBase)
UpdateSourceExceptionFilter	會取得或設定一個處理器，讓你用來提供自訂邏輯，處理綁定引擎在更新綁定來源值時遇到的異常。 這只適用於你將 與ExceptionValidationRuleMultiBinding物件關聯時。
UpdateSourceTrigger	取得或設定一個值，決定綁定原始碼更新的時機。
ValidatesOnDataErrors	取得或設定一個值，指示是否包含 。DataErrorValidationRule
ValidatesOnExceptions	取得或設定一個值，指示是否包含 。ExceptionValidationRule
ValidatesOnNotifyDataErrors	取得或設定一個值，指示是否包含 。NotifyDataErrorValidationRule
ValidationRules	取得此實例MultiBinding的物件集合ValidationRule。

方法

名稱	Description
ProvideValue(IServiceProvider)	回傳一個物件，該物件應該設在該綁定與擴充的屬性上。 (繼承來源 BindingBase)
ShouldSerializeBindings()	表示該屬性是否 Bindings 應該被保留。
ShouldSerializeFallbackValue()	回傳一個值，指示序列化程序是否應該序列化該屬性在此類實例上的有效值 FallbackValue 。 (繼承來源 BindingBase)
ShouldSerializeTargetNullValue()	回傳一個值，指示該屬性是否 TargetNullValue 應該被序列化。 (繼承來源 BindingBase)
ShouldSerializeValidationRules()	表示該屬性是否 ValidationRules 應該被保留。

明確介面實作

名稱	Description
IAddChild.AddChild(Object)	新增一個子物件。
IAddChild.AddText(String)	將節點的文字內容加入物件。

另請參閱

• IMultiValueConverter