Xamarin Forms FlyoutItem图标绑定首次渲染后不更新问题咨询

1. 确保ViewModel属性正确触发属性变更通知 #

绑定属性必须实现INotifyPropertyChanged接口，属性值更新时主动触发PropertyChanged事件，UI才能收到变更通知，示例代码：

private ImageSource _flyoutIcon;
public ImageSource FlyoutIcon
{
    get => _flyoutIcon;
    set
    {
        _flyoutIcon = value;
        // 必须触发属性变更通知
        OnPropertyChanged(nameof(FlyoutIcon));
    }
}

// Shell属性变更回调方法示例
public void Shell_PropertyChanged(object sender, PropertyChangedEventArgs e)
{
    if (e.PropertyName == nameof(Shell.FlyoutIsPresented))
    {
        var shell = sender as Shell;
        FlyoutIcon = shell.FlyoutIsPresented 
            ? "opened_icon.png" 
            : "closed_icon.png";
    }
}

2. 显式指定绑定模式为OneWay #

Shell的FlyoutItem图标默认绑定模式在部分平台为OneTime（仅首次加载生效），需要在XAML中显式指定绑定模式为OneWay：

<FlyoutItem 
    Title="首页"
    Icon="{Binding FlyoutIcon, Mode=OneWay}">
    <!-- Shell内容配置 -->
</FlyoutItem>

如果是代码中创建的FlyoutItem，绑定代码也要指定模式：

var flyoutItem = new FlyoutItem();
flyoutItem.SetBinding(FlyoutItem.IconProperty, 
    new Binding(nameof(AppShellViewModel.FlyoutIcon), BindingMode.OneWay));

3. 修正绑定源作用域问题 #

FlyoutItem的绑定上下文可能出现继承异常，可显式指定绑定源为Shell的BindingContext：

<!-- 先给AppShell根节点添加x:Name="appShell"属性 -->
<FlyoutItem 
    Title="首页"
    Icon="{Binding BindingContext.FlyoutIcon, Mode=OneWay, Source={x:Reference Name=appShell}}">

4. 绕过图片缓存问题 #

部分平台会对相同路径的本地图片做缓存，即使属性变更也会复用缓存的图片，你可以在切换图标时返回新的FileImageSource实例而非直接传字符串路径：

FlyoutIcon = shell.FlyoutIsPresented 
    ? new FileImageSource { File = "opened_icon.png" }
    : new FileImageSource { File = "closed_icon.png" };

5. 版本兼容问题 #

如果你使用的是.NET MAUI早期版本（.NET 6），存在FlyoutItem图标绑定更新失效的已知Bug，可升级到.NET 7及以上稳定版修复，或者临时通过手动设置FlyoutItem.Icon属性的方式绕过：

// 在AppShell的属性变更回调中直接赋值，绕过绑定bug
this.PropertyChanged += (obj, args) => 
{
    if (args.PropertyName == nameof(FlyoutIsPresented))
    {
        // 直接给指定FlyoutItem的Icon属性赋值
        targetFlyoutItem.Icon = FlyoutIsPresented ? "opened_icon.png" : "closed_icon.png";
    }
};

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