.NET MAUI 8中ListView绑定数据后显示空白问题求助

1. 修复UI线程访问问题 #

你使用了ConfigureAwait(false)，这会导致后续代码在非UI线程执行，直接操作currentHomes、hud等UI元素会引发线程安全问题，进而导致UI无法正常更新。可以通过两种方式修正：

// 方式1：移除ConfigureAwait(false)，确保异步操作后回到UI线程
hud.IsRunning = true;
homes = await WebServices.ws.HomesGetAsync();
currentHomes.ItemsSource = homes;
currentHomes.IsVisible = true;
hud.IsRunning = false;

// 方式2：保留ConfigureAwait(false)，但将UI操作切换回主线程
hud.IsRunning = true;
homes = await WebServices.ws.HomesGetAsync().ConfigureAwait(false);
MainThread.BeginInvokeOnMainThread(() => {
    currentHomes.ItemsSource = homes;
    currentHomes.IsVisible = true;
    hud.IsRunning = false;
});

注：代码中两次OnPropertyChanged(nameof(homes))属于无效操作，因为你是直接给ItemsSource赋值，而非通过XAML绑定{Binding homes}，可以直接删除。

2. 确保数据源类型适配UI通知 #

如果homes是普通List<T>，建议替换为ObservableCollection<T>，它会自动向UI发送集合变更通知，适配ListView的更新需求。本地模拟数据也要遵循这个规则：

// 初始化时声明为ObservableCollection
private ObservableCollection<HomeModel> homes = new ObservableCollection<HomeModel>();

// 获取数据后更新集合
homes.Clear();
foreach(var home in await WebServices.ws.HomesGetAsync())
{
    homes.Add(home);
}
currentHomes.ItemsSource = homes;

3. 核对绑定属性与数据模型的一致性 #

确认你的HomeModel类中存在大小写完全匹配的FirstImageOfHouse、address1、addressFormatted公共属性，MAUI绑定区分大小写，且属性必须可访问：

public class HomeModel
{
    public string FirstImageOfHouse { get; set; }
    public string address1 { get; set; }
    public string addressFormatted { get; set; }
}

4. 修正XAML布局异常 #

你的ActivityIndicator放在了ContentPage.Content外部，不符合MAUI布局规范，会导致布局异常影响ListView显示。建议用Grid将加载指示器和ListView叠加：

<ContentPage.Content>
    <Grid>
        <ActivityIndicator IsRunning="false" x:Name="hud" 
                           HorizontalOptions="Center" VerticalOptions="Center" />
        <ListView x:Name="currentHomes" Header="Homes" IsVisible="False">
            <ListView.ItemTemplate>
                <DataTemplate>
                    <ImageCell ImageSource="{Binding FirstImageOfHouse}" 
                               Text="{Binding address1}" 
                               Detail="{Binding addressFormatted}" />
                </DataTemplate>
            </ListView.ItemTemplate>
        </ListView>
    </Grid>
</ContentPage.Content>

5. 调试验证绑定状态 #

• 在currentHomes.ItemsSource = homes;行添加断点，查看homes的元素数量及属性值是否正常。
• 开启绑定错误追踪：在页面根元素添加命名空间xmlns:diagnostics="clr-namespace:Microsoft.Maui.Controls.Diagnostics;assembly=Microsoft.Maui.Controls"，然后给ListView添加属性diagnostics:VisualDiagnostics.TraceBindingErrors="True"，通过输出窗口查看绑定错误提示。

内容的提问来源于stack exchange，提问作者Wallace B. McClure