如何修复Xamarin.Forms中CollectionView设Single选择模式时多点同时点击报错问题

异常原因 #

你遇到的System.ArgumentOutOfRangeException不属于业务代码抛出的异常，所以你在SelectionChangedCommand和SelectedItem逻辑外层包裹的try-catch无法捕获：该异常是Xamarin.Forms底层CollectionView处理多点同时点击时，并发更新选中状态与条目索引映射关系出错导致的。单点选择模式下系统会同时处理两次选中请求，第二次请求的索引可能已经被第一次操作（或业务逻辑中的集合修改操作）变更，进而触发索引越界。

修复方案 #

• 配置原生平台触摸行为，禁止多点触摸分发
  首先在XAML头部添加平台配置命名空间：

  xmlns:android="clr-namespace:Xamarin.Forms.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.Forms.Core"
  xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
  

  然后修改你的CollectionView配置，添加平台专属属性：

  <CollectionView ItemsSource="{Binding Content}" ItemsUpdatingScrollMode="KeepItemsInView"
  SelectionMode="Single" SelectedItem="{Binding SelectedData}"                            
  SelectionChangedCommand="{Binding DoDisplay}" 
  ItemTemplate="{StaticResource dataTemplateSelector}"    
  android:ViewGroup.SplitMotionEvents="false"
  ios:CollectionView.DelaysContentTouches="true"                 
  />
  

  安卓端SplitMotionEvents="false"会禁止将多点触摸事件分发给不同的子条目，iOS端DelaysContentTouches="true"会延迟子视图的触摸响应，避免同时触发多个条目点击。

• 给选中逻辑加并发锁，避免重复处理
  在你的ViewModel中添加处理锁，同一时间只处理一次选中请求，避免并发操作导致索引错乱：

  // 选中处理锁字段
  private bool _isProcessingSelection;
  // 你的DoDisplay命令修改为如下逻辑
  public ICommand DoDisplay => new Command(async () =>
  {
      // 已经在处理选中逻辑则直接跳过
      if (_isProcessingSelection || SelectedData == null) 
          return;
      try
      {
          _isProcessingSelection = true;
          // 此处放入你原来的业务处理逻辑
      }
      finally
      {
          // 重置选中状态和锁
          SelectedData = null;
          _isProcessingSelection = false;
      }
  });
  

• 其他优化建议

  1. 如果你的Content集合会在选中逻辑中动态增删元素，建议使用支持批量更新的ObservableRangeCollection替换原生ObservableCollection，减少CollectionChanged事件触发频率，避免索引匹配出错。
  2. 升级Xamarin.Forms到5.0.0.2515及以上稳定版，该版本已经修复了多个CollectionView多点点击触发索引越界的已知BUG。

内容的提问来源于stack exchange，提问作者Steven-Carrot