.NET 8 Maui应用中RelayCommand绑定按钮无响应求助

问题背景 #

• BaseViewModel继承自ObservableObject
• 传统WPF MVVM方案在纯MAUI App中无法让ICommands正常工作，但在MAUI Blazor Hybrid应用中可正常运行
• 使用最新版MAUI的RelayCommand实现，但按钮的Command绑定始终无效

精简代码 #

SignInViewModel.cs #

public partial class SignInViewModel : BaseViewModel
{
    public RelayCommand UserLoginCommand { get; set; }

    public SignInViewModel()
    {
        UserLoginCommand = new RelayCommand(UserLogin);
    }

    async void UserLogin()
    {
       ...
    }
}

XAML标记 #

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:NMMaui"
    x:Class="NMMaui.Views.SignInPage"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
    xmlns:vm="clr-namespace:NMMaui.ViewModels"
    Title="Sign In"
    HeightRequest="600"
    Background="Silver">
    <ContentPage.BindingContext>
        <vm:SignInViewModel/>
    </ContentPage.BindingContext>
    <VerticalStackLayout>
        <Grid RowDefinitions="Auto,*">
            <Button 
            Grid.Row="10" 
            Text="Sign In" 
            FontAttributes="Bold" 
            TextColor="White" 
            Margin="0,20" 
            HeightRequest="50" 
            CornerRadius="10"
            HorizontalOptions="Center"
            Command="{Binding UserLoginCommand}"
            BackgroundColor="#508390">
            </Button>
        </Grid>
    </VerticalStackLayout>
</ContentPage>

解决步骤 #

1. 确认RelayCommand的正确引用
   必须使用MAUI Toolkit提供的RelayCommand，对应命名空间为CommunityToolkit.Mvvm.Input。如果是自定义实现，务必确保正确实现ICommand接口的CanExecuteChanged事件和CanExecute方法，否则命令状态无法更新。

2. 修复异步命令的返回类型
   async void仅适用于事件处理程序，用于RelayCommand会导致异常无法捕获、命令状态异常。建议改为async Task并使用异步重载：

   public RelayCommand UserLoginCommand { get; set; }
   
   public SignInViewModel()
   {
       UserLoginCommand = new RelayCommand(async () => await UserLogin());
   }
   
   async Task UserLogin()
   {
       // 原有业务逻辑
   }
   

   或者直接使用AsyncRelayCommand：

   public IAsyncRelayCommand UserLoginCommand { get; set; }
   
   public SignInViewModel()
   {
       UserLoginCommand = new AsyncRelayCommand(UserLogin);
   }
   
   async Task UserLogin()
   {
       // 原有业务逻辑
   }
   

3. 修正Grid布局错误
   XAML中Grid仅定义了2行（Auto,*），但按钮设置Grid.Row="10"会导致按钮被放置在不存在的行上，实际处于不可点击区域。将Grid.Row="10"改为Grid.Row="1"或直接移除（默认行索引为0），确保按钮在可见可点击区域内。

4. 验证BindingContext有效性

   • 检查XAML中vm命名空间是否指向正确的ViewModel程序集和命名空间
   • 在页面构造函数中添加调试代码，确认BindingContext实例正确：

     public SignInPage()
     {
         InitializeComponent();
         Debug.WriteLine($"BindingContext Type: {BindingContext.GetType().Name}");
     }
     

5. 启用绑定诊断排查错误
   在MauiProgram.cs中添加日志配置，查看输出窗口的绑定错误信息：

   builder.Services.AddLogging(logging =>
   {
       logging.AddDebug();
       logging.SetMinimumLevel(LogLevel.Debug);
   });
   

   若存在'UserLoginCommand' property not found类错误，需检查命令属性名称拼写或访问修饰符。

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