C#中的`ListView`和`ListViewItem`是用于展示和操作项目列表的核心控件。`ListView`负责承载和管理整个列表（例如文件浏览器、任务列表），而`ListViewItem`则代表列表中的单个数据项[ref_1][ref_4]。它们主要应用于Windows Forms（WinForm）和Windows Presentation Foundation（WPF）两大技术框架中，在用法和属性上有相似之处，但也有显著区别。 ### 1. 核心概念与区别 为了清晰展示不同框架下这两个核心组件的异同，以下是两者的对比表格： | 特性 | WinForm 的 ListView 和 ListViewItem | WPF 的 ListView 和 ListViewItem | | :--- | :--- | :--- | | **架构/理念** | 基于过程式代码的控件，更直接，逻辑通常在UI后端。 | 基于MVVM（Model-View-ViewModel）设计模式，强调数据绑定和样式与逻辑分离。 | | **数据填充方式** | 主要通过在代码中创建`ListViewItem`对象并添加到`ListView.Items`集合[ref_3][ref_4]。 | 主要使用数据绑定，通过`ItemsSource`属性绑定到数据集合。 | | **列头定义** | 使用`Columns`属性集合，添加`ColumnHeader`对象来定义[ref_3][ref_6]。 | 使用`GridView`作为`View`，在其`GridView.Columns`集合中定义`GridViewColumn`。 | | **项内容定义** | 通过`ListViewItem.SubItems`集合来定义每个列的数据（子项）[ref_3][ref_4]。 | 通过数据模板（`ItemTemplate`）定义，使用`GridViewColumn`的`DisplayMemberBinding`或`CellTemplate`来指定列内容。 | | **样式自定义** | 修改`ListViewItem`的属性，如`BackColor`、`ForeColor`等。支持`OwnerDraw`模式进行完全自定义绘制。 | 使用XAML样式（`Style`）和模板（`ControlTemplate`）进行高度自定义，分离外观与内容[ref_1]。 | | **事件处理** | 直接订阅事件，如`ItemClick`、`MouseDoubleClick`，在事件处理器中编写业务逻辑。 | 可通过`Interaction.Behaviors`或附加属性（`AttachedProperty`）将事件转换为命令，在ViewModel中处理[ref_5]。 | | **视图模式** | 通过`View`属性切换：`LargeIcon`、`SmallIcon`、`List`、`Details`（报表视图）、`Tile`[ref_2][ref_4][ref_6]。 | 本身无固定模式，通过设置`View`属性为不同的`ViewBase`派生对象（如`GridView`、`TileView`）实现。 | | **优点** | 简单直接，上手快，适合小型应用或需要快速构建UI的场景。 | 高度灵活，易于维护和扩展，数据驱动UI，适合大型、复杂、需要频繁变更UI的应用。 | | **常见问题** | 子项不显示（未设置`View`为`Details`模式且未添加`Columns`）、图标不显示（未正确关联`ImageList`）[ref_2]。 | 初次学习曲线陡峭，需要理解数据绑定、样式和模板等概念。 | ### 2. WinForm 中 ListView 与 ListViewItem 的用法 以下是一个WinForms的示例，展示如何创建一个具有多列的`Details`视图的`ListView`，并添加数据项。 **步骤 1： 初始化 ListView 并添加列** ```csharp // 假设这是Form的构造函数或在Load事件中 private void InitializeListView() { // 1. 设置ListView的基础属性 listView1.View = View.Details; // 设置为报表视图，这是显示多列的关键[ref_2][ref_4] listView1.FullRowSelect = true; // 点击选中整行[ref_4] listView1.MultiSelect = false; // 设置为单选 listView1.GridLines = true; // 显示网格线 // 2. 添加列标题（ColumnHeader） listView1.Columns.Add("姓名", 100, HorizontalAlignment.Left); listView1.Columns.Add("年龄", 60, HorizontalAlignment.Center); listView1.Columns.Add("部门", 150, HorizontalAlignment.Left); } ``` **步骤 2： 创建并添加 ListViewItem** `ListViewItem`表示列表中的一行，其`Text`属性对应第一列的内容，后续列的内容通过`SubItems`集合添加[ref_3][ref_4]。 ```csharp private void AddSampleItems() { // 创建第一个项（一行数据） ListViewItem item1 = new ListViewItem("张三"); // “张三”是主项文本，显示在第一列 item1.SubItems.Add("28"); // 添加子项，显示在第二列（年龄） item1.SubItems.Add("技术研发部"); // 添加子项，显示在第三列（部门） // 可以设置更多的属性，如图标索引、颜色等 // item1.BackColor = Color.LightBlue; // 创建第二个项 ListViewItem item2 = new ListViewItem(new string[] { "李四", "35", "市场部" }); // 使用字符串数组初始化，一次性设置主项和所有子项 // 将项添加到ListView中 listView1.Items.Add(item1); listView1.Items.Add(item2); } ``` **步骤 3： 图标和视图模式** ```csharp private void SetupImageListAndView() { // 关联图像列表（用于大/小图标视图） ImageList largeImageList = new ImageList(); largeImageList.Images.Add(Properties.Resources.UserIcon); // 添加图标 listView1.LargeImageList = largeImageList; // 大图标列表[ref_4] // listView1.SmallImageList = smallImageList; // 设置小图标列表 // 为ListViewItem指定图标索引 listView1.Items[0].ImageIndex = 0; listView1.Items[1].ImageIndex = 0; // 切换视图模式 // listView1.View = View.LargeIcon; // 切换到大图标视图[ref_6] // listView1.View = View.List; // 切换到列表视图 } ``` ### 3. WPF 中 ListView 与 ListViewItem 的用法 WPF使用XAML进行声明式UI设计，并大量使用数据绑定。`ListViewItem`通常由`ListView`根据数据自动生成，其样式通过`ItemContainerStyle`或`ItemTemplate`控制[ref_1]。 **步骤 1： 定义数据模型（Model）** ```csharp // 在C#代码中定义数据类 public class Employee { public string Name { get; set; } public int Age { get; set; } public string Department { get; set; } } ``` **步骤 2： 在XAML中定义ListView及视图（GridView）** `GridView`是WPF中为`ListView`提供多列详情视图的标准方式[ref_1]。 ```xml <Window x:Class="WpfApp.MainWindow" ...> <Grid> <ListView x:Name="EmployeeListView"> <!-- 设置ListView的视图为GridView --> <ListView.View> <GridView> <!-- 定义列 --> <GridViewColumn Header="姓名" Width="100" DisplayMemberBinding="{Binding Name}"/> <GridViewColumn Header="年龄" Width="60"> <GridViewColumn.CellTemplate> <DataTemplate> <TextBlock Text="{Binding Age}" HorizontalAlignment="Center"/> </DataTemplate> </GridViewColumn.CellTemplate> </GridViewColumn> <GridViewColumn Header="部门" Width="150" DisplayMemberBinding="{Binding Department}"/> </GridView> </ListView.View> <!-- 通过ItemContainerStyle自定义ListViewItem的外观 --> <ListView.ItemContainerStyle> <Style TargetType="ListViewItem"> <Setter Property="HorizontalContentAlignment" Value="Stretch"/> <!-- 可以添加触发器来改变选中行的样式 --> <Style.Triggers> <Trigger Property="IsSelected" Value="True"> <Setter Property="Background" Value="LightBlue"/> </Trigger> </Style.Triggers> </Style> </ListView.ItemContainerStyle> </ListView> </Grid> </Window> ``` **步骤 3： 在C#代码后台进行数据绑定** ```csharp public partial class MainWindow : Window { public MainWindow() { InitializeComponent(); // 创建数据集合 List<Employee> employees = new List<Employee> { new Employee { Name = "张三", Age = 28, Department = "技术研发部" }, new Employee { Name = "李四", Age = 35, Department = "市场部" } }; // 将数据集合赋值给ListView的ItemsSource EmployeeListView.ItemsSource = employees; } } ``` ### 4. 常见问题与解决方案 根据参考资料，以下是一些常见问题及解决方法[ref_2]： | 问题 | 可能原因 | 解决方案 | | :--- | :--- | :--- | | **WinForm: ListView在Details视图下子项不显示** | `View`属性未设置为`View.Details`；未添加`ColumnHeader`。 | 确保`listView1.View = View.Details;`，并使用`listView1.Columns.Add(...)`添加足够数量的列。 | | **WinForm: 图标不显示** | 未正确设置`LargeImageList`或`SmallImageList`；`ListViewItem`的`ImageIndex`未设置或设置错误。 | 1. 创建`ImageList`对象并添加图片。2. 将`ImageList`对象赋值给`ListView`的`LargeImageList`/`SmallImageList`属性。3. 为每个`ListViewItem`设置正确的`ImageIndex`。 | | **WPF: ListViewItem双击事件处理** | 直接在XAML中订阅`MouseDoubleClick`事件会破坏MVVM模式。 | 使用附加属性（Attached Property）将双击事件转换为命令，在ViewModel中处理逻辑[ref_5]。 | | **WPF: 如何高度自定义项的外观？** | 对控件的模板和样式不熟悉。 | 使用`ItemTemplate`属性定义整个项的内容模板，或使用`ItemContainerStyle`修改`ListViewItem`容器的样式，结合`ControlTemplate`进行完全重写[ref_1]。 | **总结**：`ListView`和`ListViewItem`是构建数据列表界面的基础。在WinForm中，主要通过过程式代码进行配置和填充，强调直接控制。在WPF中，则通过数据绑定、样式和模板进行声明式定义，更符合现代UI开发模式，可维护性和扩展性更强。选择哪种方式取决于项目架构和开发者的熟练程度。遇到问题时，应首先检查视图模式、数据源绑定、样式设置等关键配置项。