.NET MAUI CollectionView中自定义SectionTitle组件绑定失效问题

1. 检查自定义组件内的绑定方式 #

在SectionTitle的XAML中，若直接用{Binding LabelText}绑定内部Label的Text属性，会因为组件继承了CollectionView项的BindingContext（即CardItem实例），导致绑定尝试在CardItem中寻找LabelText属性而非组件自身的可绑定属性。

修复方式：使用RelativeSource指定绑定源为组件本身：

<!-- SectionTitle.xaml -->
<ContentView ...>
    <Frame BackgroundColor="{Binding BGColor, RelativeSource={RelativeSource AncestorType={x:Type local:SectionTitle}}}">
        <Label Text="{Binding LabelText, RelativeSource={RelativeSource AncestorType={x:Type local:SectionTitle}}}" />
    </Frame>
</ContentView>

或者使用x:Reference直接引用组件：

<!-- SectionTitle.xaml -->
<ContentView ... x:Name="self">
    <Frame BackgroundColor="{Binding BGColor, Source={x:Reference self}}">
        <Label Text="{Binding LabelText, Source={x:Reference self}}" />
    </Frame>
</ContentView>

2. 验证可绑定属性的定义是否规范 #

确保LabelText和BGColor的可绑定属性注册完全符合.NET MAUI的要求，尤其是属性名称、所有者类型的一致性：

// SectionTitle.xaml.cs
public static readonly BindableProperty LabelTextProperty =
    BindableProperty.Create(
        nameof(LabelText),
        typeof(string),
        typeof(SectionTitle),
        string.Empty);

public string LabelText
{
    get => (string)GetValue(LabelTextProperty);
    set => SetValue(LabelTextProperty, value);
}

public static readonly BindableProperty BGColorProperty =
    BindableProperty.Create(
        nameof(BGColor),
        typeof(Color),
        typeof(SectionTitle),
        Colors.Transparent);

public Color BGColor
{
    get => (Color)GetValue(BGColorProperty);
    set => SetValue(BGColorProperty, value);
}

注意：注册时的第一个参数必须和CLR属性名完全一致（用nameof避免硬编码错误），所有者类型必须是SectionTitle。

3. 确认CardItem模型的属性有效性 #

检查CardItem的Label属性是否为public，若需要动态更新则必须实现INotifyPropertyChanged接口：

public class CardItem : INotifyPropertyChanged
{
    private string _label;
    public string Label
    {
        get => _label;
        set
        {
            _label = value;
            OnPropertyChanged();
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
    private void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

静态展示场景下，至少保证Label是public可读属性。

4. 检查CollectionView中的绑定语法 #

确保在CollectionView的ItemTemplate中，SectionTitle的LabelText绑定路径与CardItem的属性名完全匹配：

<!-- 使用SectionTitle的页面XAML -->
<CollectionView ItemsSource="{Binding CardItems}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <local:SectionTitle LabelText="{Binding Label}" BGColor="{StaticResource SectionBgColor}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

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