MultiBinding多路绑定

MultiBinding

MultiBinding类

描述附加到单个绑定目标属性的 Binding 对象的集合。

您可以在MultiBinding对象中指定多个绑定。当您将MultiBinding对象与转换器一起使用时，它将基于这些绑定的值为绑定目标生成最终值。例如，颜色可能是根据红色，蓝色和绿色值计算出来的，这些值可以是来自相同或不同绑定源对象的值。当值从目标移到源时，目标属性值将转换为一组值，这些值会反馈到绑定中。

Mode和UpdateSourceTrigger属性的值确定MultiBinding的功能，并且用作集合中所有绑定的默认值，除非单个绑定覆盖这些属性。例如，如果MultiBinding对象上的Mode属性设置为TwoWay，则集合中的所有绑定均被视为TwoWay，除非您在其中一个绑定上显式设置了不同的Mode值。有关更多信息，请参见Binding.Mode和Binding.UpdateSourceTrigger属性。

MultiBinding当前仅支持Binding类型的对象，而不支持MultiBinding或PriorityBinding类型的对象。

MultiBinding 属性

名称	备注	权限
Bindings	获取此 MultiBinding 实例中的 Binding 对象的集合。	get;
Converter	获取或设置用于在源值和目标值之间来回转换的转换器。	get; set;
ConverterCulture	获取或设置 CultureInfo 对象，该对象应用于任何分配给绑定（由 MultiBinding 包装或是在 MultiBinding 自身上）的转换器。	get; set;
ConverterParameter	获取或设置要作为其他信息传递给转换器的可选参数。	get; set;
Mode	获取或设置一个值，该值指示此绑定的数据流的方向。	get; set;
NotifyOnSourceUpdated	获取或设置一个值，该值指示当值从绑定目标传输到绑定源时是否引发 SourceUpdated 事件。	get; set;
NotifyOnTargetUpdated	获取或设置一个值，该值指示当值从绑定源传输到绑定目标时是否引发 TargetUpdated 事件。	get; set;
NotifyOnValidationError	获取或设置一个值，该值指示是否对绑定元素引发 Error 附加事件。	get; set;
UpdateSourceExceptionFilter	获取或设置一个处理程序，可使用该程序提供自定义逻辑，旨在在更新绑定源值期间处理绑定引擎遇到的异常。 这仅适用于你已将 ExceptionValidationRule 与 MultiBinding 对象相关联的情况。	get; set;
UpdateSourceTrigger	获取或设置一个值，它可确定绑定源更新的计时。	get; set;
ValidatesOnDataErrors	获取或设置一个值，该值指示是否包含 DataErrorValidationRule。	get; set;
ValidatesOnExceptions	获取或设置一个值，该值指示是否包含 ExceptionValidationRule。	get; set;
ValidatesOnNotifyDataErrors	获取或设置一个值，该值指示是否包含 NotifyDataErrorValidationRule。	get; set;
ValidationRules	获取此 MultiBinding 实例的 ValidationRule 对象的集合。	get;

MultiBinding方法

名称	备注	权限
ShouldSerializeBindings	指示是否应使 Bindings 属性持久化。	public
ShouldSerializeValidationRules	指示是否应使 ValidationRules 属性持久化。	public

MultiBinding接口

名称	备注
IAddChild.AddChild	void IAddChild.AddChild (object value);
IAddChild.AddText	void IAddChild.AddText (string text);

 

---

范例

XAML范例

<Window x:Class="MultiBindingDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:MultiBindingDemo"
        mc:Ignorable="d"
        Title="MainWindow" Height="250" Width="400">
    <StackPanel>
        <Label HorizontalAlignment="Center" VerticalAlignment="Center">
            <Ellipse Width="30" Height="30" Margin="2">
                <Ellipse.Fill>
                    <MultiBinding >
                        <MultiBinding.Converter>
                            <local:RGBMultiCoverter/>
                        </MultiBinding.Converter>
                        <Binding Path="Value" ElementName="sld_R"/>
                        <Binding Path="Value" ElementName="sld_G"/>
                        <Binding Path="Value" ElementName="sld_B"/>
                    </MultiBinding>
                </Ellipse.Fill>
            </Ellipse>
        </Label>
        <Slider x:Name="sld_R"  IsSnapToTickEnabled="True"  Maximum="255" Margin="2"/>
        <Slider x:Name="sld_G"  IsSnapToTickEnabled="True"  Maximum="255" Margin="2"/>
        <Slider x:Name="sld_B"   IsSnapToTickEnabled="True" Maximum="255" Margin="2"/>
    </StackPanel>
</Window>

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace MultiBindingDemo
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
    }

    public class RGBMultiCoverter : IMultiValueConverter
    {
        public object Convert(object[] values, Type targetType, object parameter, CultureInfo culture)
        {
             return new SolidColorBrush(new Color { R = byte.Parse(values[0].ToString()),
 G = byte.Parse(values[1].ToString()), 
B = byte.Parse(values[2].ToString()), A = 255 });          
        }

        public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture)
        {
            throw new NotImplementedException();
        }
    }
}

 

C#范例

<Window x:Class="MultiBindingDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:MultiBindingDemo"
        mc:Ignorable="d"
        Title="MainWindow" Height="250" Width="400">
</Window>

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace MultiBindingDemo
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            StackPanel stackPanel = new StackPanel();

            Label label = new Label();
            Ellipse ellipse = new Ellipse() {Width=30,Height=30, Margin = new Thickness(2) };
            label.Content = ellipse;
            label.HorizontalAlignment = HorizontalAlignment.Center;
            label.VerticalAlignment = VerticalAlignment.Center;

            Slider sld_R = new Slider() { IsSnapToTickEnabled = true, Maximum = 255 ,Margin=new Thickness(2)};
            Slider sld_G = new Slider() { IsSnapToTickEnabled = true, Maximum = 255, Margin = new Thickness(2) };
            Slider sld_B = new Slider() { IsSnapToTickEnabled = true, Maximum = 255, Margin = new Thickness(2) };

            Binding bindingR = new Binding("Value") { Source = sld_R };
            Binding bindingG = new Binding("Value") { Source = sld_G };
            Binding bindingB = new Binding("Value") { Source = sld_B };
            MultiBinding multiBinding = new MultiBinding();
            multiBinding.Bindings.Add(bindingR);
            multiBinding.Bindings.Add(bindingG);
            multiBinding.Bindings.Add(bindingB);
            multiBinding.Converter = new RGBMultiCoverter();

            ellipse.SetBinding(Ellipse.FillProperty, multiBinding);

            stackPanel.Children.Add(label);
            stackPanel.Children.Add(sld_R);
            stackPanel.Children.Add(sld_G);
            stackPanel.Children.Add(sld_B);

            this.Content = stackPanel;
        }
    }

    public class RGBMultiCoverter : IMultiValueConverter
    {
        public object Convert(object[] values, Type targetType, object parameter, CultureInfo culture)
        {
             return new SolidColorBrush(new Color { R = byte.Parse(values[0].ToString()), G = byte.Parse(values[1].ToString()), B = byte.Parse(values[2].ToString()), A = 255 });          
        }

        public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture)
        {
            throw new NotImplementedException();
        }
    }
}