Xamarin Forms运行时修改CarouselView中Button文本异常问题求助

问题根源 #

你直接将Button UI控件作为CarouselView的数据源，同时在ItemTemplate中绑定该控件的Text属性。由于CarouselView存在视图复用机制，且数据源是控件实例本身，修改单个按钮文本时会导致多个复用视图绑定的控件属性同步变化，最终出现异常。

解决方案 #

1. 创建独立的数据模型 #

定义一个实现INotifyPropertyChanged的模型类，用于存储每个轮播项的文本数据（而非直接使用Button控件）：

using System.ComponentModel;
using System.Runtime.CompilerServices;

public class ButtonItem : INotifyPropertyChanged
{
    private string _text;
    public string Text
    {
        get => _text;
        set
        {
            _text = value;
            OnPropertyChanged();
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
    private void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

2. 替换数据源为模型列表 #

修改页面构造函数，用ButtonItem实例列表替代原来的Button控件列表：

public ButtonList()
{
    InitializeComponent();
    PlayersCarouselView.Loop = false;

    var buttonItems = new List<ButtonItem>();
    for (int i = 1; i <= 18; i++)
    {
        string suffix = (i == 9 || i == 18) ? "." : "";
        buttonItems.Add(new ButtonItem { Text = $"{i}{suffix}" });
    }

    PlayersCarouselView.ItemsSource = buttonItems;
}

3. 修改按钮点击事件处理逻辑 #

在点击事件中，通过BindingContext获取当前绑定的ButtonItem实例，修改其Text属性（而非直接修改Button控件的Text）：

void ChangeButton(object sender, EventArgs e)
{
    if (sender is Button button && button.BindingContext is ButtonItem item)
    {
        item.Text = "some text";
    }
}

4. XAML保持不变 #

原有的XAML代码无需修改，因为绑定的Text属性现在指向模型的Text字段，而非UI控件的属性：

<ContentPage.Content>
    <StackLayout>
        <CarouselView x:Name="PlayersCarouselView">
            <CarouselView.ItemTemplate>
                <DataTemplate>
                    <StackLayout>
                        <Button Text="{Binding Text}" Clicked="ChangeButton"/>
                    </StackLayout>
                </DataTemplate>
            </CarouselView.ItemTemplate>
        </CarouselView>
    </StackLayout>
</ContentPage.Content>

原理说明 #

使用独立数据模型后，每个轮播项对应一个独立的ButtonItem实例，修改模型的Text属性时，通过INotifyPropertyChanged通知UI更新。CarouselView的视图复用机制只会绑定不同的模型实例，不会出现多个视图共享同一个控件实例的问题，因此点击单个按钮只会修改当前绑定项的文本。

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