Xamarin MVVM模式下ListView选中项跳转详情页及字典键缺失问题

我来帮你一步步排查这两个问题，先搞定ListView跳转详情页的问题，再解决字典键不存在的报错。

一、修复ListView选中餐厅无法打开详情页的问题 #

在MVVM模式下，有两种常用方式处理ListView的选中跳转，你可以根据自己的项目习惯选：

方式1：绑定SelectedItem到ViewModel属性+命令触发跳转 #

1. 在餐厅列表的ViewModel里，添加选中餐厅属性和跳转命令：

private Restaurant _selectedRestaurant;
public Restaurant SelectedRestaurant
{
    get => _selectedRestaurant;
    set
    {
        _selectedRestaurant = value;
        OnPropertyChanged();
        if (value != null)
        {
            NavigateToDetailsCommand.Execute(value);
            // 重置选中状态，避免重复触发跳转
            SelectedRestaurant = null;
        }
    }
}

public ICommand NavigateToDetailsCommand { get; }

// 在ViewModel构造函数中初始化命令
public RestaurantListViewModel(INavigationService navigationService)
{
    NavigateToDetailsCommand = new Command<Restaurant>(async (restaurant) =>
    {
        await navigationService.PushAsync(new SingleDetailsAboutPricePage(), 
            new NavigationParameters { { "SelectedRestaurant", restaurant } });
    });
}

2. 在XAML中绑定ListView的SelectedItem：

<ListView ItemsSource="{Binding Restaurants}"
          SelectedItem="{Binding SelectedRestaurant}">
    <!-- 你的ItemTemplate布局 -->
</ListView>

方式2：直接用ItemSelected事件（适合不想完全依赖命令的场景） #

在列表页的代码后台添加事件处理：

private async void RestaurantListView_ItemSelected(object sender, SelectedItemChangedEventArgs e)
{
    if (e.SelectedItem is Restaurant selectedRestaurant)
    {
        await Navigation.PushAsync(new SingleDetailsAboutPricePage(selectedRestaurant));
        // 重置选中项，避免重复触发
        ((ListView)sender).SelectedItem = null;
    }
}

然后在XAML中绑定事件：

<ListView ItemsSource="{Binding Restaurants}"
          ItemSelected="RestaurantListView_ItemSelected">
    <!-- 你的ItemTemplate布局 -->
</ListView>

二、解决"The given key was not present in the dictionary"错误 #

这个报错90%是因为导航参数的键名不匹配，或者参数根本没传到字典里，按下面的步骤排查：

1. 检查参数传递与获取的键名是否完全一致 #

大小写、拼写必须完全相同！比如传递时用的是"SelectedRestaurant"，获取时就不能写成"selectedRestaurant"或者"Restaurant"：

• 传递参数的代码（参考上面的跳转逻辑）：

  await Navigation.PushAsync(new SingleDetailsAboutPricePage(), 
      new NavigationParameters { { "SelectedRestaurant", selectedRestaurant } });
  

• 获取参数的代码（在详情页ViewModel或代码后台）：

  if (NavigationParameters.TryGetValue("SelectedRestaurant", out Restaurant restaurant))
  {
      // 安全使用restaurant.RestaurantID
      var targetId = restaurant.RestaurantID;
  }
  

2. 确认参数传递方式是否匹配 #

如果你是通过构造函数直接传对象（比如new SingleDetailsAboutPricePage(selectedRestaurant)），就不要去导航参数字典里找，直接在构造函数里接收：

private Restaurant _currentRestaurant;
public SingleDetailsAboutPricePage(Restaurant restaurant)
{
    InitializeComponent();
    _currentRestaurant = restaurant;
    // 直接使用_currentRestaurant.RestaurantID
    var id = _currentRestaurant.RestaurantID;
}

3. 用安全的取值方式避免异常 #

永远不要直接用NavigationParameters["Key"]这种写法，改用TryGetValue来容错：

Restaurant selectedRestaurant;
if (NavigationParameters.TryGetValue("SelectedRestaurant", out selectedRestaurant))
{
    // 正常处理逻辑
}
else
{
    // 参数不存在时的降级处理，比如返回列表页
    await Navigation.PopAsync();
}

快速验证小技巧 #

• 跳转前打印selectedRestaurant.RestaurantID，确认值是有效的；
• 在详情页接收参数时，打印所有导航参数的键，看看有没有你要的那个：

  foreach (var key in NavigationParameters.Keys)
  {
      Debug.WriteLine($"导航参数键：{key}");
  }
  

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