MAUI中带ViewModel注入的自定义ContentView在XAML使用报错的解决方法

方案1：添加无参构造函数并复用DI注入的ViewModel #

XAML解析控件时要求提供无参构造，但我们可以让无参构造通过依赖注入（DI）容器获取ViewModel，既满足XAML的解析要求，又能保留BindingContext的正确绑定。

步骤： #

1. 先在MauiProgram.cs中注册对应的ViewModel服务：

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        });

    // 根据业务需求选择AddTransient/AddScoped/AddSingleton
    builder.Services.AddTransient<ViewOneViewModel>();
    builder.Services.AddTransient<ViewTwoViewModel>();

    return builder.Build();
}

2. 在ContentView的代码后置中添加无参构造，调用带参构造并从DI容器获取ViewModel：

public partial class ViewOne : ContentView
{
    // 供依赖注入使用的带参构造
    public ViewOne(ViewOneViewModel vm)
    {
        InitializeComponent();
        BindingContext = vm;
    }

    // 供XAML解析使用的无参构造
    public ViewOne() : this(MauiProgram.Current.Services.GetRequiredService<ViewOneViewModel>())
    {
    }
}

这样XAML中使用<controlOne:ViewOne>时就不会报错，同时BindingContext也能正确绑定到ViewModel。

方案2：使用DataTemplate实现ViewModel驱动的视图切换（推荐） #

这种方式更符合MVVM的设计思想，不需要维护多个IsVisible属性，而是通过绑定当前ViewModel来自动切换视图，代码更简洁易维护。

步骤： #

1. 在页面或全局资源字典中定义DataTemplate，关联ViewModel和对应的ContentView：

<ContentPage.Resources>
    <ResourceDictionary>
        <DataTemplate x:DataType="vm:ViewOneViewModel">
            <controlOne:ViewOne />
        </DataTemplate>
        <DataTemplate x:DataType="vm:ViewTwoViewModel">
            <ControlTwo:ViewTwo />
        </DataTemplate>
    </ResourceDictionary>
</ContentPage.Resources>

（注：vm是ViewModel命名空间的xmlns前缀，需在页面顶部声明，例如xmlns:vm="clr-namespace:YourApp.ViewModels"）

2. 在页面布局中使用ContentPresenter绑定当前ViewModel：

<StackLayout VerticalOptions="FillAndExpand" 
             HorizontalOptions="FillAndExpand" 
             IsVisible="{Binding IsSearchResultsVisible}">
    <ContentPresenter Content="{Binding CurrentViewModel}" />
</StackLayout>

3. 在页面的ViewModel中维护CurrentViewModel属性，通过切换该属性来切换视图：

public class MainPageViewModel : ObservableObject
{
    private object _currentViewModel;
    public object CurrentViewModel
    {
        get => _currentViewModel;
        set => SetProperty(ref _currentViewModel, value);
    }

    // 切换到ViewOne的命令示例
    public ICommand SwitchToViewOneCommand => new Command(() =>
    {
        CurrentViewModel = App.Current.Services.GetRequiredService<ViewOneViewModel>();
    });

    // 切换到ViewTwo的命令示例
    public ICommand SwitchToViewTwoCommand => new Command(() =>
    {
        CurrentViewModel = App.Current.Services.GetRequiredService<ViewTwoViewModel>();
    });
}

这种方式的优势在于：无需手动管理多个IsVisible状态，视图切换完全由ViewModel驱动，符合MVVM的关注点分离原则，也更适配MAUI的框架特性。

方案3：直接在XAML中指定BindingContext（不推荐） #

如果是临时应急场景，可以在XAML中直接给ContentView指定BindingContext，但这种方式会提升ViewModel与视图的耦合度，且无法处理ViewModel需要依赖注入的场景，仅适合简单场景：

<ContentPage.Resources>
    <vm:ViewOneViewModel x:Key="ViewOneViewModel" />
</ContentPage.Resources>

<!-- 布局中使用 -->
<controlOne:ViewOne BindingContext="{StaticResource ViewOneViewModel}" 
                    IsVisible="{Binding IsCurrentlyViewingViewOne}" />

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