本文目录导读：

1. ListBox的基础用法
2. 数据绑定与动态加载
3. 高级功能与实战技巧
4. 常见问题与解决方案

在C# Windows窗体应用程序中，ListBox（列表框）是一个经典且功能丰富的控件，用于展示和管理一组可选择的列表项，无论是简单的数据展示，还是复杂的交互逻辑（如动态加载、多选操作或数据绑定），ListBox都扮演着重要角色，本文将从基础用法入手，逐步探讨ListBox的高级功能，并结合实际代码示例，帮助开发者全面掌握这一控件的核心技术。

ListBox的基础用法

1 ListBox的创建与初始化

在Visual Studio中，通过拖拽工具箱中的ListBox控件到窗体上即可快速创建一个列表框，初始化时，可以通过代码动态添加项：

// 添加单个项
listBox1.Items.Add("第一项");
listBox1.Items.Add("第二项");
// 添加集合
string[] items = { "苹果", "香蕉", "橘子" };
listBox1.Items.AddRange(items);

2 常用属性与事件

• SelectedItem：获取或设置当前选中的项。
• SelectedIndex：选中项的索引（从0开始，-1表示未选中）。
• MultiColumn：是否允许多列显示。
• SelectionMode：选择模式（单选、多选等）。

常用事件包括：

• SelectedIndexChanged：选中项变化时触发。
• DoubleClick：双击某项时触发。

3 基本交互示例

通过按钮操作ListBox的增删功能：

// 添加项
private void btnAdd_Click(object sender, EventArgs e) {
    if (!string.IsNullOrEmpty(txtInput.Text)) {
        listBox1.Items.Add(txtInput.Text);
        txtInput.Clear();
    }
}
// 删除选中项
private void btnRemove_Click(object sender, EventArgs e) {
    if (listBox1.SelectedIndex != -1) {
        listBox1.Items.RemoveAt(listBox1.SelectedIndex);
    }
}

数据绑定与动态加载

1 绑定数据源

ListBox支持直接绑定数据集合（如List、数组、DataTable等），通过DataSource属性实现：

List<string> fruits = new List<string> { "苹果", "香蕉", "橘子" };
listBox1.DataSource = fruits;

对于复杂对象,可以指定显示字段：

public class Product {
    public string Name { get; set; }
    public int Price { get; set; }
}
List<Product> products = new List<Product> {
    new Product { Name = "手机", Price = 2000 },
    new Product { Name = "电脑", Price = 5000 }
};
listBox1.DisplayMember = "Name"; // 显示Name属性
listBox1.ValueMember = "Price";  // 实际值对应Price

2 动态加载与更新

当数据源变更时,需重新绑定：

products.Add(new Product { Name = "平板", Price = 3000 });
listBox1.DataSource = null; // 清空原有绑定
listBox1.DataSource = products;

高级功能与实战技巧

1 多选与批量操作

将SelectionMode设为MultiExtended，允许用户通过Ctrl或Shift键多选：

listBox1.SelectionMode = SelectionMode.MultiExtended;
// 获取所有选中项
foreach (var item in listBox1.SelectedItems) {
    MessageBox.Show(item.ToString());
}

2 自定义项样式

通过DrawMode属性实现自定义绘制：

listBox1.DrawMode = DrawMode.OwnerDrawVariable;
listBox1.MeasureItem += ListBox1_MeasureItem;
listBox1.DrawItem += ListBox1_DrawItem;
private void ListBox1_MeasureItem(object sender, MeasureItemEventArgs e) {
    e.ItemHeight = 30; // 设置项高度
}
private void ListBox1_DrawItem(object sender, DrawItemEventArgs e) {
    e.DrawBackground();
    if (e.Index >= 0) {
        // 绘制文本和图标
        e.Graphics.DrawString(listBox1.Items[e.Index].ToString(), 
                             new Font("宋体", 10), 
                             Brushes.Black, 
                             new RectangleF(e.Bounds.X, e.Bounds.Y, e.Bounds.Width, e.Bounds.Height));
    }
}

3 虚拟模式（Virtual Mode）优化性能

当列表项数量极大时（如超过10万条），启用虚拟模式可显著提升性能：

listBox1.VirtualMode = true;
listBox1.RetrieveVirtualItem += ListBox1_RetrieveVirtualItem;
private void ListBox1_RetrieveVirtualItem(object sender, RetrieveVirtualItemEventArgs e) {
    e.Item = new ListBoxItem($"第{e.ItemIndex}项");
}

常见问题与解决方案

1 数据绑定后不显示

• 原因：未正确设置DisplayMember或数据源未实现IList接口。
• 解决：检查数据源类型并确认属性名拼写正确。

2 滚动时卡顿

• 优化方案：使用BeginUpdate()和EndUpdate()批量操作：

  listBox1.BeginUpdate();
  for (int i = 0; i < 1000; i++) {
    listBox1.Items.Add("项" + i);
  }
  listBox1.EndUpdate();

3 跨线程更新问题

在异步操作中,需通过Invoke方法更新UI：

this.Invoke(new Action(() => {
    listBox1.Items.Add("新项");
}));