MAUI中ContentView绑定ViewModel失败及初始加载绑定问题求助

核心思路 #

利用MAUI控件内置的BindingContextChanged事件，该事件会在控件的BindingContext完成赋值（从null变为有效值或后续变更）时触发，刚好解决初始加载时子ContentView无法获取ViewModel的问题，同时兼容横竖屏切换场景。

具体实现步骤 #

1. 调整HomePage的XAML绑定

HomePage的BindingContext已设置为HomeViewModel，子控件HomePageOrientationViewLoader会自动继承父级BindingContext，无需显式设置BindingContext={Binding HomeViewModel}（这会导致XFC0009错误，因为相当于查找HomeViewModel的HomeViewModel属性）。简化后的HomePage XAML如下：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:views="clr-namespace:YourAppNamespace.Views"
             x:Class="YourAppNamespace.Views.HomePage"
             BindingContext="{Binding HomeViewModel, Source={RelativeSource Self}}">
    <views:HomePageOrientationViewLoader />
</ContentPage>

2. 修改HomePageOrientationViewLoader后台代码

订阅BindingContextChanged事件，在事件回调中同步ViewModel给子ContentView，同时完善横竖屏切换逻辑：

public partial class HomePageOrientationViewLoader : ContentView
{
    public HomePageOrientationViewLoader()
    {
        InitializeComponent();
        // 订阅BindingContext变更事件
        BindingContextChanged += OnBindingContextChanged;
        // 初始加载时先处理屏幕方向
        HandleOrientationChange();
    }

    private void OnBindingContextChanged(object sender, EventArgs e)
    {
        // BindingContext赋值完成后，同步给当前显示的子ContentView
        if (BindingContext != null && Content is View currentView)
        {
            currentView.BindingContext = BindingContext;
        }
    }

    // 处理屏幕方向切换，加载对应ContentView
    private void HandleOrientationChange()
    {
        var isPortrait = DeviceDisplay.MainDisplayInfo.Orientation == DisplayOrientation.Portrait;
        Content = isPortrait ? new HomePagePortrait() : new HomePageLandscape();
        
        // 若此时BindingContext已存在，直接同步给新创建的ContentView
        if (BindingContext != null)
        {
            Content.BindingContext = BindingContext;
        }
    }

    // 监听屏幕方向变更
    protected override void OnAppearing()
    {
        base.OnAppearing();
        DeviceDisplay.MainDisplayInfoChanged += OnMainDisplayInfoChanged;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        DeviceDisplay.MainDisplayInfoChanged -= OnMainDisplayInfoChanged;
    }

    private void OnMainDisplayInfoChanged(object sender, DisplayInfoChangedEventArgs e)
    {
        HandleOrientationChange();
    }
}

关键说明 #

• BindingContextChanged事件覆盖了初始加载和横竖屏切换两种场景，确保子ContentView在任何时候都能获取到正确的ViewModel。
• 子控件自动继承父级BindingContext的逻辑，避免了手动绑定的错误，同时简化了代码结构。

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