.NET MAUI启用编译绑定后CollectionView中Command无法触发的解决方法

启用编译绑定后，带有显式Source属性的绑定会被XamlC跳过编译（也就是XC0025警告的原因），导致命令无法正常触发。以下是几种在保持编译绑定启用的前提下的解决方法：

方法1：用RelativeSource/ElementName替代显式Source #

将绑定中的Source={x:Reference}替换为RelativeSource，让编译绑定能够识别并处理该绑定。

示例：
原来的XAML（会被跳过编译）：

<CollectionView ItemsSource="{Binding Logs}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Button Text="查看详情" 
                    Command="{Binding NavigateToLogDetailsCommand, Source={x:Reference MainPage}}"
                    CommandParameter="{Binding}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

修改后：

<CollectionView ItemsSource="{Binding Logs}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Button Text="查看详情" 
                    Command="{Binding NavigateToLogDetailsCommand, RelativeSource={RelativeSource AncestorType={x:Type local:MainPage}}}"
                    CommandParameter="{Binding}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

这里local:MainPage是你的页面类型的命名空间引用，确保在XAML顶部已声明对应命名空间。

方法2：将命令移到列表项的ViewModel中 #

如果CollectionView绑定的是项ViewModel集合，直接把NavigateToLogDetailsCommand放到每个项的ViewModel里，绑定无需指定Source，编译绑定完全支持。

示例：
项ViewModel（LogItemViewModel）：

public class LogItemViewModel : ObservableObject
{
    public LogModel Log { get; set; }
    public ICommand NavigateToLogDetailsCommand { get; }

    public LogItemViewModel(INavigationService navigationService)
    {
        NavigateToLogDetailsCommand = new Command(async () =>
        {
            await navigationService.NavigateToAsync<LogDetailsPage>(Log);
        });
    }
}

页面ViewModel：

public class MainPageViewModel : ObservableObject
{
    public ObservableCollection<LogItemViewModel> Logs { get; }

    public MainPageViewModel(INavigationService navigationService)
    {
        Logs = new ObservableCollection<LogItemViewModel>(
            GetLogsFromApi().Select(log => new LogItemViewModel(navigationService) { Log = log })
        );
    }
}

XAML绑定：

<CollectionView ItemsSource="{Binding Logs}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Button Text="查看详情" 
                    Command="{Binding NavigateToLogDetailsCommand}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

这种方式更符合MVVM单一职责原则，同时完美适配编译绑定。

方法3：使用x:Bind替代Binding #

x:Bind对编译绑定的支持更友好，可以通过显式指定Source实现绑定，不会被跳过编译。

示例：

<CollectionView ItemsSource="{Binding Logs}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Button Text="查看详情" 
                    Command="{x:Bind Source={x:Reference MainPage}, Path=BindingContext.NavigateToLogDetailsCommand, Mode=OneWay}"
                    CommandParameter="{x:Bind}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

注意x:Bind默认是OneTime模式，如果命令可能动态更新，需要指定Mode=OneWay。

方法4：修改项目配置强制编译带Source的绑定 #

可以在.csproj文件中添加额外属性，强制XamlC编译带有Source的绑定：

<PropertyGroup>
    <MauiEnableXamlCBindingWithSourceCompilation>true</MauiEnableXamlCBindingWithSourceCompilation>
    <MauiXamlCompileBindingsWithSource>true</MauiXamlCompileBindingsWithSource>
</PropertyGroup>

不过这个属性并非所有.NET MAUI版本都支持，建议优先使用前三种方法，此方法作为兜底方案。

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