求Xamarin Forms+MvvmCross的MasterDetailPage示例，解决主页面替换报错

先聊聊你遇到的错误 #

这个报错本质上是因为MvvmCross对应用的MainPage有自己的管理逻辑——如果你跳过MvvmCross的导航系统，直接手动替换Application.Current.MainPage或者修改MasterDetailPage的根页面，就会触发这个异常。正确的做法是完全交由MvvmCross的导航机制来处理页面切换，不要直接操作原生页面层级。

优质的MvvmCross + MasterDetailPage 实现示例 #

下面是一套符合MvvmCross最佳实践的完整实现，涵盖视图、ViewModel和配置环节：

1. 定义MasterDetail相关视图 #

使用MvvmCross提供的MvxMasterDetailPage控件，配合属性标记明确Master/Detail角色：

using MvvmCross.Forms.Presenters.Attributes;
using MvvmCross.Forms.Views;
using YourApp.Core.ViewModels;

namespace YourApp.Forms.Views
{
    // 侧边栏页面
    [MvxMasterDetailPagePresentation(Position = MvxMasterDetailPosition.Master, WrapInNavigationPage = false)]
    public partial class MainSidebarView : MvxContentPage<MainSidebarViewModel>
    {
        public MainSidebarView()
        {
            InitializeComponent();
        }
    }

    // 默认详情页面
    [MvxMasterDetailPagePresentation(Position = MvxMasterDetailPosition.Detail, WrapInNavigationPage = true)]
    public partial class HomeDetailView : MvxContentPage<HomeDetailViewModel>
    {
        public HomeDetailView()
        {
            InitializeComponent();
        }
    }

    // 主容器页面
    public partial class MainMasterDetailView : MvxMasterDetailPage<MainMasterDetailViewModel>
    {
        public MainMasterDetailView()
        {
            InitializeComponent();
            // 无需手动设置Master/Detail，MvvmCross会通过属性标记自动关联
        }
    }
}

2. 对应的ViewModel结构 #

ViewModel通过IMvxNavigationService处理导航，完全遵循MvvmCross的生命周期：

using MvvmCross.Commands;
using MvvmCross.Navigation;
using MvvmCross.ViewModels;

namespace YourApp.Core.ViewModels
{
    // 主容器ViewModel，作为导航入口
    public class MainMasterDetailViewModel : MvxViewModel
    {
        private readonly IMvxNavigationService _navigationService;

        public MainMasterDetailViewModel(IMvxNavigationService navigationService)
        {
            _navigationService = navigationService;
        }

        public override async Task Initialize()
        {
            await base.Initialize();
            // 初始化时导航到默认详情页
            await _navigationService.Navigate<HomeDetailViewModel>();
        }
    }

    // 侧边栏ViewModel，处理侧边栏导航逻辑
    public class MainSidebarViewModel : MvxViewModel
    {
        private readonly IMvxNavigationService _navigationService;

        public IMvxAsyncCommand GoToSettingsCommand { get; }
        public IMvxAsyncCommand GoToProfileCommand { get; }

        public MainSidebarViewModel(IMvxNavigationService navigationService)
        {
            _navigationService = navigationService;

            GoToSettingsCommand = new MvxAsyncCommand(NavigateToSettings);
            GoToProfileCommand = new MvxAsyncCommand(NavigateToProfile);
        }

        private async Task NavigateToSettings()
        {
            // 导航到设置页，自动替换详情区域
            await _navigationService.Navigate<SettingsViewModel>();
            // 导航后自动关闭侧边栏
            if (Application.Current.MainPage is MasterDetailPage masterDetail)
                masterDetail.IsPresented = false;
        }

        private async Task NavigateToProfile()
        {
            await _navigationService.Navigate<ProfileViewModel>();
            if (Application.Current.MainPage is MasterDetailPage masterDetail)
                masterDetail.IsPresented = false;
        }
    }

    // 各详情页ViewModel示例
    public class HomeDetailViewModel : MvxViewModel { }
    public class SettingsViewModel : MvxViewModel { }
    public class ProfileViewModel : MvxViewModel { }
}

3. 配置导航Presenter #

在Setup类中确保正确注册MasterDetail导航处理器：

using MvvmCross.Forms.Presenters;
using MvvmCross.Forms.Presenters.Attributes;
using MvvmCross.IoC;
using MvvmCross.ViewModels;

namespace YourApp.Forms
{
    public class Setup : MvxFormsAndroidSetup<Core.App, Forms.App>
    {
        protected override IMvxFormsPagePresenter CreateFormsPagePresenter(IMvxFormsViewPresenter viewPresenter)
        {
            var presenter = new MvxFormsPagePresenter(viewPresenter, MvxFormsPagePresenter.DefaultMasterDetailPagePresenter);
            presenter.AddPresentationHandler(new MvxMasterDetailPagePresentationHandler());
            return presenter;
        }

        protected override void InitializeFirstViewModel()
        {
            // 启动时直接导航到MasterDetail容器
            NavigationService.Navigate<MainMasterDetailViewModel>();
        }
    }
}

关键注意事项 #

• 绝对不要直接修改Application.Current.MainPage或者MasterDetailPage的Master/Detail属性，所有页面切换都通过IMvxNavigationService完成。
• 必须用MvxMasterDetailPagePresentation标记页面角色，让MvvmCross清楚页面在结构中的位置。
• 确保Setup类正确配置了MasterDetailPresenter，这是导航系统正常工作的前提。

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