Xamarin.Forms如何通过XAML属性向自定义ContentView传值到ViewModel

自定义ContentView绑定传值失效的核心原因是控件自身显式赋值BindingContext阻断了父级绑定上下文继承，叠加BindableProperty类型与传入值不匹配的小问题，最终导致ViewModel的Guid属性始终拿不到父页面传入的值，一直显示空Guid。

Xamarin.Forms的绑定规则默认沿可视化树向上继承BindingContext：你在TestContentView构造函数中直接给控件自身设置了独立ViewModel作为BindingContext，会导致父页面XAML中写的ArbitraryGuid="{Binding MainPageID}"无法找到父页面的绑定源——此时控件的BindingContext已经是自身的VM，不再继承TestMainPage的BindingContext，绑定自然获取不到MainPageID的值，属性变更回调永远拿不到有效Guid。

完全可以保留自定义视图使用独立ViewModel的设计，仅需调整2处逻辑即可：

• 不给ContentView自身设置BindingContext，仅给控件内部承载UI的内容节点设置ViewModel作为绑定上下文，避免打断父级绑定继承链
• 调整BindableProperty的类型、默认值与传入值匹配，同时在控件初始化完成后主动同步一次属性值，覆盖静态传值的场景

调整后的TestContentView.xaml.cs代码 #

using ExampleDataBinding.ViewModels;
using System;
using Xamarin.Forms;
using Xamarin.Forms.Xaml;

namespace ExampleDataBinding.Views
{
    [XamlCompilation(XamlCompilationOptions.Compile)]
    public partial class TestContentView : ContentView
    {
        public static readonly BindableProperty ArbitraryGuidProperty = BindableProperty.Create(
            propertyName: nameof(ArbitraryGuid),
            returnType: typeof(Guid),
            declaringType: typeof(TestContentView),
            defaultValue: Guid.Empty,
            defaultBindingMode: BindingMode.TwoWay,
            propertyChanged: ArbitraryGuidPropertyChanged);

        private static void ArbitraryGuidPropertyChanged(BindableObject bindable, object oldValue, object newValue)
        {
            if (bindable is TestContentView currentView && newValue is Guid targetGuid)
            {
                currentView.viewModel.Guid = targetGuid;
            }
        }

        public Guid ArbitraryGuid
        {
            get => (Guid)GetValue(ArbitraryGuidProperty);
            set => SetValue(ArbitraryGuidProperty, value);
        }

        private readonly TestContentViewModel viewModel = new TestContentViewModel();

        public TestContentView()
        {
            InitializeComponent();
            // 仅给内部UI内容设置VM绑定上下文，不修改控件自身的BindingContext
            Content.BindingContext = viewModel;
            // 初始化时主动同步一次值，兼容静态传值场景
            ArbitraryGuidPropertyChanged(this, null, ArbitraryGuid);
        }
    }
}

TestContentView.xaml 无需大改 #

保持内部绑定逻辑即可，如果要保留编译绑定，可将x:DataType声明移到内部内容节点：

<?xml version="1.0" encoding="UTF-8"?>
<ContentView xmlns="http://xamarin.com/schemas/2014/forms" 
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" 
             xmlns:viewmodels="clr-namespace:ExampleDataBinding.ViewModels"
             x:Class="ExampleDataBinding.Views.TestContentView">
    <ContentView.Content>
        <Label x:DataType="viewmodels:TestContentViewModel" Text="{Binding Guid}" />
    </ContentView.Content>
</ContentView>

其余代码（App、TestMainPage、TestContentViewModel）均不需要修改，运行后即可正常显示父页面传入的Guid值。

开发Xamarin.Forms自定义可绑定控件时，记住一个核心原则：

永远不要给自定义控件自身设置BindingContext，否则一定会打断父级绑定上下文的继承，导致控件上暴露的BindableProperty无法正常接收父页面的绑定值。

如果控件需要使用独立ViewModel，只需要把控件内部的根UI容器/Content的BindingContext指向VM即可，控件本身保持默认的BindingContext继承行为，所有对外暴露的可绑定属性就能正常工作。

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