MAUI自定义ContentView绑定值无法显示问题求助

问题描述 #

自定义了CountBubble这个ContentView，XAML中设置了BindingContext指向自身，C#代码定义了Count可绑定属性。在页面中使用时，同页面的Label绑定MenuItem.Count能正常显示数值，但CountBubble绑定同一个属性却始终显示0；硬编码Count数值时控件显示正常，但绑定状态下Count的setter和OnCountPropertyChanged断点均未触发。

问题原因 #

核心问题出在ContentView的BindingContext设置上：自定义控件内部设置了BindingContext="{Binding Source={RelativeSource Self}}"，这会覆盖外部页面传入的绑定上下文，导致控件的Count属性无法正确关联到页面ViewModel中的MenuItem.Count。

解决方案 #

1. 移除控件自身的BindingContext自绑定 #

删除XAML中BindingContext="{Binding Source={RelativeSource Self}}"这一行，避免覆盖外部绑定上下文。

2. 修改Label的绑定路径，明确指向控件自身 #

将Label的Text绑定改为通过RelativeSource指定绑定到控件自身的Count属性，确保内部显示不受外部上下文影响：

修改后的CountBubble XAML代码：

<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:contentViews="clr-namespace:CleanApp.ContentViews"
             x:Class="CleanApp.ContentViews.CountBubble">
    <Border
        StrokeShape="RoundRectangle 5,5,5,5"
        StrokeThickness="1"
        BackgroundColor="LightGray"
        Opacity=".65"
        HeightRequest="20">
        <Label 
            x:Name="CountText"
            Text="{Binding Source={RelativeSource AncestorType={x:Type contentViews:CountBubble}}, Path=Count}"
            FontSize="12"
            HorizontalTextAlignment="Center"
            VerticalTextAlignment="Center"
            Padding="0"/>
    </Border>
</ContentView>

3. 可选：简化C#代码（移除冗余逻辑） #

由于Label已经通过绑定直接关联Count属性，无需再通过OnCountPropertyChanged手动更新Text，可以简化可绑定属性的定义：

public partial class CountBubble : ContentView
{
    public static readonly BindableProperty CountProperty =
        BindableProperty.Create(nameof(Count), typeof(int), typeof(CountBubble), 0, BindingMode.TwoWay);

    public int Count 
    {
        get => (int)GetValue(CountProperty);
        set => SetValue(CountProperty, value);
    }

    public CountBubble()
    {
        InitializeComponent();
    }
}

生效逻辑说明 #

移除控件自身的BindingContext设置后，外部页面中Count="{Binding MenuItem.Count}"的绑定就能正常使用页面ViewModel作为上下文，正确传递数值；而Label通过RelativeSource绑定到控件自身的Count属性，保证内部显示逻辑独立，不受外部上下文干扰。

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