.NET MAUI MenuItem的Text与IconImageSource绑定失效问题排查

一、菜单文本不更新的原因及修复 #

使用[ObservableProperty]生成属性时，直接赋值私有字段_loginIcon/_loginText不会触发属性变更通知。该特性生成的是自带通知逻辑的公共属性（LoginIcon/LoginText），只有通过公共属性赋值，才会自动调用OnPropertyChanged让UI感知到数据变化。

修复代码： #

将构造函数和ToggleLoginAsync方法中的私有字段赋值替换为公共属性：

public Menu()
{
    LoginIcon = App.IsLoggedIn ? _iconSignOut : _iconSignIn;
    LoginText = App.IsLoggedIn ? _textSignOut : _textSignIn;
}

[ICommand]
protected async Task ToggleLoginAsync()
{
    ...
    LoginIcon = App.IsLoggedIn ? _iconSignOut : _iconSignIn;
    LoginText = App.IsLoggedIn ? _textSignOut : _textSignIn;
    ...
}

二、图标不显示的原因及修复 #

MenuItem.IconImageSource绑定的是字符串资源键，但MAUI不会自动将字符串转换为静态资源引用，可通过以下两种方式修复：

方式1：在XAML绑定中使用StaticResource标记扩展 #

修改MenuItem的图标绑定，直接通过资源键引用静态资源：

<MenuItem Text="{Binding LoginText}"
          IconImageSource="{StaticResource {Binding LoginIcon}}"
          Command="{Binding ToggleLoginCommand}" />

方式2：在Menu类中直接返回ImageSource类型 #

修改Menu类的属性类型，直接从应用资源中获取ImageSource对象：

// 替换原ObservableProperty定义
[ObservableProperty]
private ImageSource _loginIcon;

public Menu()
{
    LoginIcon = App.Current.Resources[App.IsLoggedIn ? _iconSignOut : _iconSignIn] as ImageSource;
    LoginText = App.IsLoggedIn ? _textSignOut : _textSignIn;
}

[ICommand]
protected async Task ToggleLoginAsync()
{
    ...
    LoginIcon = App.Current.Resources[App.IsLoggedIn ? _iconSignOut : _iconSignIn] as ImageSource;
    LoginText = App.IsLoggedIn ? _textSignOut : _textSignIn;
    ...
}

完成上述修改后，菜单文本会随登录状态切换更新，图标也能正常显示。

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