Xamarin Forms带编译绑定的自定义控件开发及Source绑定问题咨询

问题背景 #

微软文档明确指出：

当前，任何定义了Source属性的绑定表达式均禁用编译绑定。这是因为Source属性始终通过x:Reference标记扩展设置，无法在编译时解析。

在自定义控件开发中，原本采用的绑定写法如下：
ImageSource="{Binding Image, Source={x:Reference Host}}"

后台对应的可绑定属性定义：

public UriImageSource Image
{
     get => (UriImageSource)GetValue(ImageProperty);
     set => SetValue(ImageProperty, value);
}

需要找到既能引用控件可绑定属性，又能启用编译绑定的可行方案。

解决方案：用RelativeSource替代x:Reference #

编译绑定支持RelativeSource的绑定模式，可通过以下方式修改绑定逻辑：

1. 绑定到当前控件本身 #

如果Host指的是当前自定义控件，直接使用RelativeSource Self：

ImageSource="{Binding Image, RelativeSource={RelativeSource Self}, Mode=OneWay}"

2. 绑定到上级父控件 #

如果Host是当前控件的父级自定义控件，使用RelativeSource FindAncestor指定目标控件类型：

ImageSource="{Binding Image, RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:HostControl}}, Mode=OneWay}"

（需将local:HostControl替换为实际的父控件类型及对应命名空间）

3. 启用编译绑定 #

• 全局启用：在页面或控件的根元素添加x:CompileBindings="True"属性

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:CompileBindings="True"
             ...>

• 单个绑定启用：在绑定表达式中添加x:CompileBinding=True

ImageSource="{Binding Image, RelativeSource={RelativeSource Self}, x:CompileBinding=True}"

原理说明 #

RelativeSource的绑定模式可在编译阶段被解析，无需依赖x:Reference的运行时元素查找逻辑，编译绑定能提前验证绑定路径的正确性，既实现了控件间的属性绑定需求，又保留了编译绑定的性能优势。

内容的提问来源于stack exchange，提问作者Grudzinski