Xamarin Forms ListView绑定ObservableCollection中子对象列表问题

嗨，别担心，刚上手Xamarin.Forms遇到嵌套绑定的问题太正常了！我来一步步给你拆解怎么实现绑定子对象（比如GameType）和子列表（比如Prize）的需求～

首先，不管是顶层的GameDTOModel还是子对象GameType、Prize，最好都实现INotifyPropertyChanged接口——这是Xamarin.Forms绑定能自动更新UI的核心。举个示例代码：

using System.ComponentModel;
using System.Runtime.CompilerServices;
using System.Collections.ObjectModel;

public class GameDTOModel : INotifyPropertyChanged
{
    private string _gameName;
    public string GameName
    {
        get => _gameName;
        set { _gameName = value; OnPropertyChanged(); }
    }

    // 单个子对象
    private GameType _gameType;
    public GameType GameType
    {
        get => _gameType;
        set { _gameType = value; OnPropertyChanged(); }
    }

    // 子对象列表
    private ObservableCollection<Prize> _prizes;
    public ObservableCollection<Prize> Prizes
    {
        get => _prizes;
        set { _prizes = value; OnPropertyChanged(); }
    }

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

// 子对象GameType的示例实现
public class GameType : INotifyPropertyChanged
{
    private string _typeName;
    public string TypeName
    {
        get => _typeName;
        set { _typeName = value; OnPropertyChanged(); }
    }

    // 可以添加其他属性，比如TypeDescription等
    public event PropertyChangedEventHandler PropertyChanged;
    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

// 子对象Prize的示例实现
public class Prize : INotifyPropertyChanged
{
    private string _prizeName;
    public string PrizeName
    {
        get => _prizeName;
        set { _prizeName = value; OnPropertyChanged(); }
    }

    // 比如再加个PrizeValue属性
    private decimal _prizeValue;
    public decimal PrizeValue
    {
        get => _prizeValue;
        set { _prizeValue = value; OnPropertyChanged(); }
    }

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

如果只是要展示GameType里的某个属性（比如TypeName），直接用点语法绑定就行，和顶层属性一样简单：

<!-- 假设你的ViewModel里有一个ObservableCollection<GameDTOModel>类型的属性Games -->
<ListView ItemsSource="{Binding Games}">
    <ListView.ItemTemplate>
        <DataTemplate>
            <ViewCell>
                <StackLayout Padding="12">
                    <!-- 绑定顶层属性 -->
                    <Label Text="{Binding GameName}" FontSize="Headline" />
                    <!-- 绑定子对象的属性，用点语法穿透 -->
                    <Label Text="{Binding GameType.TypeName}" FontSize="Caption" TextColor="Gray" Margin="0,4,0,0" />
                    <!-- 如果子对象可能为null，加TargetNullValue避免空引用异常 -->
                    <Label Text="{Binding GameType.TypeDescription, TargetNullValue='无描述'}" FontSize="Caption" TextColor="Gray" />
                </StackLayout>
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

如果要展示每个Game对应的奖品列表，有两种常用方案，根据你的需求选：

方案一：嵌套ListView #

适合需要子列表独立滚动的场景，直接在父ListView的ItemTemplate里嵌套一个ListView：

<ListView ItemsSource="{Binding Games}">
    <ListView.ItemTemplate>
        <DataTemplate>
            <ViewCell>
                <StackLayout Padding="12">
                    <Label Text="{Binding GameName}" FontSize="Headline" />
                    <Label Text="奖品列表" FontSize="Subtitle" Margin="0,8,0,4" />
                    <!-- 嵌套ListView绑定子列表 -->
                    <ListView ItemsSource="{Binding Prizes}" HeightRequest="120" SeparatorVisibility="None">
                        <ListView.ItemTemplate>
                            <DataTemplate>
                                <ViewCell>
                                    <StackLayout Orientation="Horizontal" Padding="4">
                                        <Label Text="{Binding PrizeName}" />
                                        <Label Text="{Binding PrizeValue, StringFormat='({0:C})'}" Margin="8,0,0,0" TextColor="Green" />
                                    </StackLayout>
                                </ViewCell>
                            </DataTemplate>
                        </ListView.ItemTemplate>
                    </ListView>
                </StackLayout>
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

⚠️ 注意：嵌套ListView偶尔会有滚动冲突，如果不需要子列表单独滚动，更推荐下面的方案。

方案二：使用BindableLayout（更轻量流畅） #

BindableLayout可以直接在普通布局（比如StackLayout）上绑定子列表，不需要嵌套ListView，体验更顺滑：

<ListView ItemsSource="{Binding Games}">
    <ListView.ItemTemplate>
        <DataTemplate>
            <ViewCell>
                <StackLayout Padding="12">
                    <Label Text="{Binding GameName}" FontSize="Headline" />
                    <Label Text="奖品列表" FontSize="Subtitle" Margin="0,8,0,4" />
                    <!-- 用BindableLayout绑定子列表 -->
                    <StackLayout BindableLayout.ItemsSource="{Binding Prizes}">
                        <BindableLayout.ItemTemplate>
                            <DataTemplate>
                                <StackLayout Orientation="Horizontal" Padding="4" BackgroundColor="#f5f5f5" Margin="0,2,0,2">
                                    <Label Text="{Binding PrizeName}" />
                                    <Label Text="{Binding PrizeValue, StringFormat='({0:C})'}" Margin="8,0,0,0" TextColor="Green" />
                                </StackLayout>
                            </DataTemplate>
                        </BindableLayout.ItemTemplate>
                    </StackLayout>
                </StackLayout>
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

• 所有绑定的属性必须触发PropertyChanged事件：如果属性更新后UI没变化，大概率是忘了调用OnPropertyChanged()。
• 子列表要用ObservableCollection<T>：如果需要动态增删子对象，必须用这个类型（List<T>不会自动通知UI更新）。
• 处理null情况：如果子对象可能为null，记得用TargetNullValue或者FallbackValue避免空引用异常，比如上面示例里的写法。

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