DevExpress.XtraGrid.GridControl绑定List笔记

最近公司计划按业务domain拆分系统，原有系统客户端用到DevExpress组件，报表展示都是通过GridControl绑定DataTable实现。考虑到和服务端交互数据的性能问题，在项目升级的同时，想把DataTable替换掉。 GridControl绑定IList<T>比较简单，但是在调试主从表效果时，一直没能达到预期效果，子列表的列名一直显示相应类的字段名称。这个问题令人大伤脑筋，调试过程着实花了一番功夫，但是问题的解决方法却让人大跌眼镜。 考虑到关于这个问题在网上比较难找，所以这里做了个分享，希望对碰到同样问题的朋友有所帮助。 在.NET开发中，DevExpress是一个广泛使用的控件库，其中的GridControl是用于创建高级数据网格视图的强大工具。在本文中，我们将深入探讨如何将DevExpress的GridControl与List<T>对象进行绑定，以及如何处理主从表显示的问题。 在传统的数据绑定中，GridControl常常与DataTable或DataSet一起使用，但考虑到性能和效率，开发人员可能会选择更轻量级的数据结构，如List<T>。List<T>是.NET框架中System.Collections.Generic命名空间内的一个泛型集合类，它提供了添加、删除和访问元素的高效方式，特别适合于内存中的数据操作。 当尝试将GridControl与IList<T>绑定时，需要确保GridControl能够正确地解析T类型的实例，以便正确显示数据。在这个例子中，我们有两个实体类：StudentEntity和StuCourseEntity，分别代表学生信息和学生选课信息。StudentEntity有一个CourseList属性，它是一个StuCourseEntity对象的List。 在设置GridControl的主从表显示时，通常需要配置详细信息列（Detail Column）来展示子列表。然而，问题在于，当GridControl尝试显示CourseList时，列名显示为类的字段名称，而不是用户友好的标题。这是因为默认情况下，GridControl会根据字段名来生成列头。 解决这个问题的关键在于提供自定义列标题。你可以通过以下几种方式实现： 1. 使用ColumnView的Columns集合来手动创建和配置列。例如，对于每个StuCourseEntity的属性，你可以创建一个新的GridColumn，并设置其FieldName为对应的属性名，DisplayName为你想要的列标题。 2. 在实体类中，利用DataAnnotations的DisplayAttribute来自定义显示名称。例如，在StuCourseEntity的属性上添加[Display(Name="课程名称")]，这样GridControl会自动识别并使用指定的名称。 3. 实现IListSource接口，提供一个自定义的BindingSource，这样可以控制列的生成逻辑。 4. 如果使用的是XtraGrid，还可以利用GridView.DataColumns集合，设置Column.FieldName和Column.Caption属性，或者利用ColumnOptionsColumn.ShowHeaderFilterButton属性来控制列头显示。 在调试过程中，可能会发现即使设置了正确的DisplayName或FieldNames，GridControl仍然无法正确显示。这可能是因为在数据绑定时，没有正确地更新GridControl的DataSource或DataMember属性。确保在设置完数据源后，调用GridControl的RefreshData()方法，以刷新数据并应用新的列设置。 将DevExpress GridControl绑定到List<T>需要对数据绑定和控件的内部工作原理有深入理解。遇到列名显示异常的问题时，检查数据模型、数据源设置以及列配置是解决问题的关键步骤。通过以上的方法，我们可以确保GridControl按照预期显示数据，同时提高代码的可读性和用户体验。希望这个解决方案能帮助到那些在类似问题上遇到困扰的开发者们。