Avalonia ListBox怎么动态添加数据 Avalonia绑定ObservableCollection方法

来源：这里教程网时间：2026-02-21 17:37:07 作者：

在 Avalonia 中动态添加数据到

ListBox

，核心是使用支持通知的集合（如

ObservableCollection<t></t>

）并正确绑定到控件的

Items

属性。只要集合实现了

INotifyCollectionChanged

，UI 就会自动响应增删改操作。

确保 ViewModel 继承

INotifyPropertyChanged

并暴露 ObservableCollection

ViewModel 需要是一个可绑定的数据上下文，并公开一个

ObservableCollection<t></t>

类型的属性：

public class MainViewModel : INotifyPropertyChanged
{
    private ObservableCollection<string> _items = new();
    public ObservableCollection<string> Items => _items;
    // 可选：提供添加方法
    public void AddItem(string item) => _items.Add(item);
    public event PropertyChangedEventHandler? PropertyChanged;
    protected virtual void OnPropertyChanged([CallerMemberName] string? propertyName = null)
        => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
}

在 XAML 中正确绑定 ListBox.Items

确保

ListBox

的

Items

属性绑定到 ViewModel 中的集合属性，且 DataContext 已设置：

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:vm="using:YourApp.ViewModels"
        x:Class="YourApp.MainWindow">
    <Window.DataContext>
        <vm:MainViewModel />
    </Window.DataContext>
    <ListBox Items="{Binding Items}" />
</Window>

注意：不要用

ItemsSource

（这是 WPF/UWP 的写法），Avalonia 中统一用

Items

属性绑定集合。

动态添加数据的几种常用方式

直接调用
ObservableCollection.Add()
—— 最常用，UI 立即更新在 ViewModel 中封装添加逻辑（如
AddItem()
），便于测试和复用若需批量添加，可用
foreach
循环调用
Add()
；如追求性能，可考虑继承
ObservableCollection
实现
AddRange
方法（需手动触发
OnCollectionChanged
）避免直接赋值新集合（如
Items = new ObservableCollection<string>();</string>
），否则绑定会断开；如需重置，请清空原集合：
_items.Clear()
，再逐个添加

进阶提示：绑定项模板与数据类型

如果显示的是自定义对象（如

Person

），记得设置

ListBox.ItemTemplate

或依赖默认字符串转换：

<ListBox Items="{Binding People}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
                <TextBlock Text="{Binding Name}" />
                <TextBlock Text="{Binding Age}" Margin="5,0,0,0" />
            </StackPanel>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

确保