x:Bind 中的函数

  • 项目

注意

有关将应用中的数据绑定与 {x:Bind} 结合使用的常规信息（以及有关 {x:Bind} 和 {Binding} 之间的全方位比较），请参阅深入了解数据绑定和 {x:Bind} 标记扩展。

从 Windows 10 版本 1607 开始， {x:Bind} 支持使用某个函数作为绑定路径的叶步。 这样做可以实现以下操作：

  • 实现值转换的更简单方法
  • 依赖多个参数适用于绑定的方法

注意

若要使用 {x:Bind} 的函数，你的应用的最低目标 SDK 版本必须为 14393 或更高版本。 当你的应用面向较早版本的 Windows 10 时，无法使用这些函数。 有关目标版本的详细信息，请参阅版本自适应代码。

在以下示例中，项目的背景和前景会绑定到这些函数，根据颜色参数执行转换。

<DataTemplate x:DataType="local:ColorEntry">
    <Grid Background="{x:Bind local:ColorEntry.Brushify(Color), Mode=OneWay}" Width="240">
        <TextBlock Text="{x:Bind ColorName}" Foreground="{x:Bind TextColor(Color)}" Margin="10,5" />
    </Grid>
</DataTemplate>

class ColorEntry
{
    public string ColorName { get; set; }
    public Color Color { get; set; }

    public static SolidColorBrush Brushify(Color c)
    {
        return new SolidColorBrush(c);
    }

    public SolidColorBrush TextColor(Color c)
    {
        return new SolidColorBrush(((c.R * 0.299 + c.G * 0.587 + c.B * 0.114) > 150) ? Colors.Black : Colors.White);
    }
}

XAML 属性使用方法

<object property="{x:Bind pathToFunction.FunctionName(functionParameter1, functionParameter2, ...), bindingProperties}" ... />

函数的路径

与其他属性路径一样指定该函数的路径，可以包含用于定位该函数的点 (.)、索引器或强制转换。

可以使用 XMLNamespace:ClassName.MethodName 语法指定静态函数。 例如，使用以下语法在代码隐藏中绑定到静态函数。

<Page 
     xmlns:local="using:MyNamespace">
     ...
    <StackPanel>
        <TextBlock x:Name="BigTextBlock" FontSize="20" Text="Big text" />
        <TextBlock FontSize="{x:Bind local:MyHelpers.Half(BigTextBlock.FontSize)}" 
                   Text="Small text" />
    </StackPanel>
</Page>

namespace MyNamespace
{
    static public class MyHelpers
    {
        public static double Half(double value) => value / 2.0;
    }
}

还可以直接在标记中使用系统函数来完成简单方案，如日期格式设置、文本格式设置、文本串联等。例如：

<Page 
     xmlns:sys="using:System"
     xmlns:local="using:MyNamespace">
     ...
     <CalendarDatePicker Date="{x:Bind sys:DateTime.Parse(TextBlock1.Text)}" />
     <TextBlock Text="{x:Bind sys:String.Format('{0} is now available in {1}', local:MyPage.personName, local:MyPage.location)}" />
</Page>

如果模式为单向/双向，函数路径将对它执行更改检测，并且将重新计算绑定（如果对这些对象进行了更改）。

要绑定的函数需要：

  • 可以访问代码和元数据 - 因此 internal / private 在 C# 中有效，但 C++/CX 需要方法为公有 WinRT 方法。
  • 重载基于参数数目，而不是基于参数类型，并且它将尝试匹配第一个带有许多参数的重载。
  • 参数类型需要匹配将传入的数据 - 我们不执行收缩转换
  • 函数的返回类型需要匹配正使用绑定的属性的类型

绑定引擎会对用函数名称触发的属性更改通知做出反应，并在必要时重新计算绑定。 例如：

<DataTemplate x:DataType="local:Person">
   <StackPanel>
      <TextBlock Text="{x:Bind FullName}" />
      <Image Source="{x:Bind IconToBitmap(Icon, CancellationToken), Mode=OneWay}" />
   </StackPanel>
</DataTemplate>

public class Person : INotifyPropertyChanged
{
    //Implementation for an Icon property and a CancellationToken property with PropertyChanged notifications
    ...

    //IconToBitmap function is essentially a multi binding converter between several options.
    public Uri IconToBitmap (Uri icon, Uri cancellationToken)
    {
        Uri foo = new Uri(...);        
        if (isCancelled)
        {
            foo = cancellationToken;
        }
        else 
        {
            if (this.fullName.Contains("Sr"))
            {
               //pass a different Uri back
               foo = new Uri(...);
            }
            else
            {
                foo = icon;
            }
        }
        return foo;
    }

    //Ensure FullName property handles change notification on itself as well as IconToBitmap since the function uses it
    public string FullName
    {
        get { return this.fullName; }
        set
        {
            this.fullName = value;
            this.OnPropertyChanged ();
            this.OnPropertyChanged ("IconToBitmap"); 
            //this ensures Image.Source binding re-evaluates when FullName changes in addition to Icon and CancellationToken
        }
    }
}

提示

可以使用 x:Bind 中的函数来实现特定的方案，这些方案与通过 WPF 中的转换器和 MultiBinding 实现的方案相同。

函数参数

可以指定多个函数参数，用逗号 (,) 分隔

  • 绑定路径 - 类似直接绑定该对象的语法。
    • 如果模式为单向/双向，将执行更改检查，并在更改对象后重新计算绑定
  • 使用引号括起来的常量字符串 - 需要使用引号将它指定为一个字符串。 乘幂号 (^) 可用于转义字符串中的引号
  • 常数 - 例如，-123.456
  • 布尔值 – 指定为“x:True”或“x:False”

双向函数绑定

在双向绑定方案中，必须针对绑定的相反方向指定第二个函数。 这是使用 BindBack 绑定属性完成的。 在以下示例中，函数应该有一个参数，该参数是需要返回给模型的值。

<TextBlock Text="{x:Bind a.MyFunc(b), BindBack=a.MyFunc2, Mode=TwoWay}" />

请参阅