CarouselPage，Children.Add生成异常‘值不能为空，参数名: key’

CarouselPage 是 Xamarin.Forms 中的一个控件，用于创建一个可以滑动浏览的页面集合。当你在 CarouselPage 的 Children 集合中使用 Add 方法添加子页面时，如果遇到 '值不能为空，参数名: key' 的异常，通常是因为添加的子页面没有正确设置 NavigationPage.Key 属性。

基础概念

• CarouselPage: 是 Xamarin.Forms 中的一个布局控件，允许用户通过滑动来切换不同的页面。
• Children: 是 CarouselPage 中的一个属性，用于存储和管理子页面的集合。
• NavigationPage.Key: 在某些情况下，Xamarin.Forms 需要一个唯一的键来识别页面，特别是在导航堆栈中。

异常原因

这个异常通常发生在以下情况：

1. 添加到 CarouselPage 的子页面没有设置 NavigationPage.Key 属性。
2. 子页面的 NavigationPage.Key 属性被设置为 null 或空字符串。

解决方法

确保每个添加到 CarouselPage 的子页面都有一个唯一的 NavigationPage.Key 属性值。以下是一个示例代码：

using Xamarin.Forms;

public class MyCarouselPage : CarouselPage
{
    public MyCarouselPage()
    {
        // 创建子页面并设置唯一的 Key
        var page1 = new ContentPage { Content = new Label { Text = "Page 1" } };
        page1.SetValue(NavigationPage.KeyProperty, "page1_key");

        var page2 = new ContentPage { Content = new Label { Text = "Page 2" } };
        page2.SetValue(NavigationPage.KeyProperty, "page2_key");

        // 添加子页面到 CarouselPage
        Children.Add(page1);
        Children.Add(page2);
    }
}

应用场景

• 滑动浏览: 适用于需要用户通过滑动来切换不同内容的场景，如图片轮播、新闻阅读等。
• 多页面展示: 当应用需要在有限的空间内展示多个页面时，可以使用 CarouselPage。

优势

• 用户体验: 提供流畅的滑动体验，适合移动设备。
• 灵活性: 可以轻松添加或移除子页面，适应不同的内容需求。

类型

• ContentPage: 最简单的页面类型，用于显示静态内容。
• NavigationPage: 提供导航功能，允许用户在不同页面间跳转。
• TabbedPage: 允许用户在多个选项卡之间切换。

通过确保每个子页面都有一个唯一的 NavigationPage.Key 属性，可以有效避免 '值不能为空，参数名: key' 异常的发生。