UWP自定义控件仅支持x:Bind无法使用Binding，如何适配？

嘿，这个问题我之前踩过坑！其实核心是自定义控件的依赖属性注册时没做好Binding适配——标准控件（比如TextBlock）的依赖属性都默认配置了支持Binding的元数据，而很多自定义控件（包括UWP Community Toolkit里的部分控件）可能只针对x:Bind做了优化，导致Binding无法识别。咱们一步步来解决：

1. 先搞懂为什么Binding不生效 #

Binding依赖控件的依赖属性具备两个关键特性：

• 依赖属性的所有者类型必须正确指向控件本身，这样Binding才能关联到控件实例
• 依赖属性的FrameworkPropertyMetadata需要配置允许数据上下文继承，或者明确绑定模式

x:Bind是编译时绑定，它直接通过类型引用找到属性，不需要依赖这些元数据配置，所以能正常工作；而Binding是运行时绑定，对元数据的要求更高。

2. 如果你是自己开发自定义控件 #

找到依赖属性的注册代码，修改成如下格式（以MinItemSize为例）：

public static readonly DependencyProperty MinItemSizeProperty =
    DependencyProperty.Register(
        nameof(MinItemSize),
        typeof(double),
        typeof(OrbitView), // 这里必须是控件自身的类型，绝对不能写错！
        new FrameworkPropertyMetadata(
            48.0, // 属性默认值
            // 关键配置：允许双向绑定（如果需要）+ 允许继承父元素的数据上下文
            FrameworkPropertyMetadataOptions.BindsTwoWayByDefault | FrameworkPropertyMetadataOptions.Inherits,
            OnMinItemSizeChanged)); // 属性值变化的回调方法

public double MinItemSize
{
    get => (double)GetValue(MinItemSizeProperty);
    set => SetValue(MinItemSizeProperty, value);
}

重点强调两个点：

• typeof(OrbitView)：必须是当前控件的类型，这是Binding能定位到属性的基础
• FrameworkPropertyMetadataOptions.Inherits：让控件能继承父元素的DataContext，这是Binding生效的前提；如果是单向绑定的属性，可以去掉BindsTwoWayByDefault，但Inherits建议保留

3. 如果是使用第三方控件（比如UWP Toolkit的OrbitView） #

你没法直接修改第三方控件的代码，这时候可以用两种方案中转Binding：

方案一：创建附加属性中转 #

写一个静态类来提供附加属性，把Binding的值传递给OrbitView的属性：

public static class OrbitViewBindingHelper
{
    public static readonly DependencyProperty BindableMinItemSizeProperty =
        DependencyProperty.RegisterAttached(
            "BindableMinItemSize",
            typeof(double),
            typeof(OrbitViewBindingHelper),
            new PropertyMetadata(48.0, OnBindableMinItemSizeChanged));

    public static double GetBindableMinItemSize(DependencyObject obj)
    {
        return (double)obj.GetValue(BindableMinItemSizeProperty);
    }

    public static void SetBindableMinItemSize(DependencyObject obj, double value)
    {
        obj.SetValue(BindableMinItemSizeProperty, value);
    }

    private static void OnBindableMinItemSizeChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is OrbitView orbitView)
        {
            orbitView.MinItemSize = (double)e.NewValue;
        }
    }
}

然后在XAML里这样使用：

<Toolkit:OrbitView local:OrbitViewBindingHelper.BindableMinItemSize="{Binding MyProperty}" />

方案二：包装成自定义UserControl #

创建一个UserControl，内部嵌套OrbitView，然后在UserControl上定义支持Binding的依赖属性，通过x:Bind转发给内部的OrbitView：

<!-- BindableOrbitView.xaml -->
<UserControl
    x:Class="YourAppNamespace.BindableOrbitView"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:toolkit="using:Microsoft.Toolkit.Uwp.UI.Controls">
    <toolkit:OrbitView MinItemSize="{x:Bind MinItemSize, Mode=OneWay}" />
</UserControl>

后台代码：

// BindableOrbitView.xaml.cs
public sealed partial class BindableOrbitView : UserControl
{
    public static readonly DependencyProperty MinItemSizeProperty =
        DependencyProperty.Register(
            nameof(MinItemSize),
            typeof(double),
            typeof(BindableOrbitView),
            new PropertyMetadata(48.0));

    public double MinItemSize
    {
        get => (double)GetValue(MinItemSizeProperty);
        set => SetValue(MinItemSizeProperty, value);
    }

    public BindableOrbitView()
    {
        this.InitializeComponent();
    }
}

使用时直接绑定UserControl的属性即可：

<local:BindableOrbitView MinItemSize="{Binding MyProperty}" />

4. 验证Binding是否生效的小技巧 #

可以给Binding加上FallbackValue来快速排查问题：

<Toolkit:OrbitView MinItemSize="{Binding MyProperty, FallbackValue='100'}" />

如果显示100，说明Binding没找到DataContext或者属性；如果显示正确的属性值，说明配置生效了。

内容的提问来源于stack exchange，提问作者Sean O'Neil