WinForm真入门(14)——ListView控件详解
一、ListView 控件核心概念与功能
ListView 是 WinForm 中用于展示结构化数据的多功能列表控件，支持多列、多视图模式及复杂交互，常用于文件资源管理器、数据报表等场景。
核心特点：
- 支持 5种视图模式：Details（详细视图）、List（列表）、LargeIcon（大图标）、SmallIcon（小图标）、Tile（平铺视图）。
- 支持 多列数据展示，可自定义列标题、列宽及对齐方式。
- 提供 整行选择、复选框操作、数据排序 等高级功能。
二、ListView 关键属性与方法
1. 核心属性
| 属性 | 说明 | 适用视图模式 |
|---|---|---|
| View | 设置视图模式（默认 LargeIcon），Details 模式显示多列数据。 | 所有模式 |
| Columns | 管理列集合（仅 Details 模式有效），支持添加列标题及设置列宽。 | Details |
| FullRowSelect | 是否启用整行选中（仅 Details 模式有效）。 | Details |
| GridLines | 显示行列分割线（仅 Details 模式有效）。 | Details |
| CheckBoxes | 在项旁显示复选框，支持多选操作。 | 所有模式 |
| Items | 管理主项集合（ListViewItem 对象），支持动态增删。 | 所有模式 |
2. 常用方法
- 动态添加项：
// 添加主项及子项
ListViewItem item = new ListViewItem("主项1");
item.SubItems.Add("子项1");
listView1.Items.Add(item);
说明：SubItems 集合用于添加子项，仅在 Details 模式下可见。
- 批量操作优化：
istView1.BeginUpdate(); // 暂停界面刷新
for (int i = 0; i < 100; i++) {
listView1.Items.Add($"Item {i}");
}
listView1.EndUpdate(); // 恢复刷新
说明：提升大数据量操作性能。
3. 核心事件
- SelectedIndexChanged：选中项变化时触发。
- ItemCheck：复选框状态变化时触发。
三、ListView 与 ListBox 的核心区别
| 对比维度 | ListView | ListBox |
|---|---|---|
| 继承关系 | 继承自 ListBox，扩展了 View 属性。 | 基础列表控件，无多视图支持。 |
| 视图模式 | 支持多列、图标视图（如 Details）。 | 仅支持单列列表。 |
| 选择模式 | 默认 Extended（扩展多选）。 | 默认 Single（单选）。 |
| 数据展示 | 可显示子项（SubItems）及多列标题。 | 仅显示简单文本项。 |
| 典型场景 | 文件资源管理器、数据库表格。 | 简单选项列表（如城市选择）。 |
四、ListView 完整案例
案例1：动态创建多列列表（Details 视图）
需求：创建包含姓名、年龄、部门的多列列表，支持整行选中。
代码实现：
// 设置视图模式及列标题
listView1.View = View.Details;
listView1.Columns.Add("姓名", 120);
listView1.Columns.Add("年龄", 80);
listView1.Columns.Add("部门", 150);
listView1.FullRowSelect = true;
// 添加数据项
List<Employee> employees = GetEmployeesFromDB(); // 假设从数据库获取数据
foreach (Employee emp in employees) {
ListViewItem item = new ListViewItem(emp.Name);
item.SubItems.Add(emp.Age.ToString());
item.SubItems.Add(emp.Department);
listView1.Items.Add(item);
}
说明：通过 SubItems 添加子项，Details 模式下显示多列数据。
案例2：多选数据导出到 Excel
需求：勾选多项后导出选中数据到 Excel 文件。
代码实现：
// 启用复选框
listView1.CheckBoxes = true;
// 导出按钮事件
private void btnExport_Click(object sender, EventArgs e) {
using (ExcelPackage package = new ExcelPackage()) {
var worksheet = package.Workbook.Worksheets.Add("数据导出");
int row = 1;
// 写入列标题
for (int i = 0; i < listView1.Columns.Count; i++) {
worksheet.Cells[1, i + 1].Value = listView1.Columns[i].Text;
}
// 写入选中项数据
foreach (ListViewItem item in listView1.CheckedItems) {
row++;
for (int col = 0; col < item.SubItems.Count; col++) {
worksheet.Cells[row, col + 1].Value = item.SubItems[col].Text;
}
}
File.WriteAllBytes("导出数据.xlsx", package.GetAsByteArray());
}
}
说明：通过 CheckedItems 集合遍历选中项，结合 Excel 库生成文件。
案例3：自定义排序与搜索
需求：按部门排序并支持关键词搜索。
代码实现：
// 自定义排序类
public class ListViewItemComparer : IComparer {
private int colIndex;
public ListViewItemComparer(int column) { colIndex = column; }
public int Compare(object x, object y) {
string a = ((ListViewItem)x).SubItems[colIndex].Text;
string b = ((ListViewItem)y).SubItems[colIndex].Text;
return string.Compare(a, b);
}
}
// 按部门排序
listView1.ListViewItemSorter = new ListViewItemComparer(2);
listView1.Sort();
// 关键词搜索
private void txtSearch_TextChanged(object sender, EventArgs e) {
listView1.BeginUpdate();
foreach (ListViewItem item in listView1.Items) {
item.BackColor = item.Text.Contains(txtSearch.Text) ? Color.Yellow : Color.White;
}
listView1.EndUpdate();
}
说明：通过自定义 IComparer 实现排序，动态高亮匹配项。
五、注意事项与最佳实践
性能优化：
- 批量操作时使用 BeginUpdate() 和 EndUpdate() 减少界面闪烁。
- 避免在循环中频繁修改 Items 集合。
索引管理：
- 删除多项时需 倒序操作，防止索引越界。
for (int i = listView1.Items.Count - 1; i >= 0; i--) {
if (条件) listView1.Items.RemoveAt(i);
}
总结
ListView 是 WinForm 中功能强大的列表控件，适用于 多列数据展示 和 复杂交互场景，而 ListBox 更适合 简单选项选择。通过合理使用 Details 视图、Columns 和 SubItems，可高效实现文件管理、报表生成等需求。开发者需结合场景选择控件，并注意性能优化与交互逻辑的完善。