MAUI绑定报错：无法找到Button.Command对应的绑定属性

核心问题分析 #

你遇到的Binding Property not found错误，本质是**[ICommand]特性生成的命令属性名称与XAML绑定的名称不匹配**，同时存在异步方法返回值不符合规范的问题，以下是分步解决方案：

1. 确认安装必要的NuGet包 #

[ICommand]和[ObservableProperty]是CommunityToolkit.Mvvm库提供的特性，首先确保你的项目已安装这个包：

• 右键项目 → 管理NuGet程序包 → 搜索CommunityToolkit.Mvvm并安装

2. 修正ViewModel的方法返回值与继承关系 #

异步命令的方法必须返回Task而非void，同时ViewModel需要继承ObservableObject才能让特性正常工作：

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;
using project.Models;

namespace project.ViewModels;

// 必须继承ObservableObject
public partial class AddUpdateObjectDetailViewModel : ObservableObject
{
    private readonly IObjectService _objectService;

    // 构造函数注入服务（如果你的服务是注入的）
    public AddUpdateObjectDetailViewModel(IObjectService objectService)
    {
        _objectService = objectService;
    }

    [ObservableProperty]
    private string _name;

    // 异步方法返回Task，而非void
    [ICommand]
    public async Task AddUpdateObject()
    {
        var response = await _objectService.AddObject(new TestModel
        {
            Name = Name
        });

        if(response > 0)
        {
            await Shell.Current.DisplayAlert("Created", "Object Created!", "OK");
        }
        else
        {
            await Shell.Current.DisplayAlert("Not Created", "Something went wrong while creating", "OK");
        }
    }
}

3. 修正XAML中的Command绑定名称 #

[ICommand]特性会自动为你的方法生成一个后缀为Command的属性，比如AddUpdateObject方法会生成AddUpdateObjectCommand，所以XAML里需要绑定这个生成的属性：

<StackLayout Margin="10" Spacing="20">
    <VerticalStackLayout Margin="10">
       <Label Text="Name" FontSize="16"/>
       <Entry Text="{Binding Name}" Placeholder="Name"/>
       <BoxView HeightRequest="0.8" Color="Gray"/>
    </VerticalStackLayout>

    <!-- 绑定生成的Command属性，而非方法名 -->
    <Button Text="Save" Command="{Binding AddUpdateObjectCommand}" />
 </StackLayout>

4. 验证BindingContext是否正确设置 #

确保你的页面后台代码中，ViewModel的实例正确赋值给了BindingContext，注意构造函数的类名要和ViewModel类名一致（你的代码里类名是AddObjectAlbumDetail，但构造函数参数是AddUpdateObjectDetailViewModel，这里要确认没有拼写错误）：

using project.ViewModels;
namespace project.Views;

public partial class AddObjectAlbumDetail : ContentPage
{
    // 确保参数类型是正确的ViewModel类
    public AddObjectAlbumDetail(AddUpdateObjectDetailViewModel viewModel)
    {
        BindingContext = viewModel;    
        InitializeComponent();
    }
}

额外检查项 #

• 清理并重新生成项目，确保特性生成的代码被正确编译
• 确认ViewModel中的_objectService已正确注入或初始化，避免后续执行命令时出现空引用错误

内容的提问来源于stack exchange，提问作者Ilian Gion Häsler