DevExpress GridControl的主从表依赖两部分：数据源中必须存在可识别的一对多关系，GridControl中还要有与该关系匹配的明细视图。展开按钮能够显示，并不代表子数据已经正确绑定。下面围绕“DevExpress GridControl怎么实现主从表DevExpress GridControl主从数据展开后显示空白如何排查”，说明常用实现方式和排查顺序。
一、DevExpress GridControl怎么实现主从表
GridControl可以自动识别DataSet中的DataRelation，也可以识别业务对象中的子集合属性。项目已经使用ADO.NET时适合采用DataSet关系；使用Entity Framework或普通实体类时，可以直接绑定包含子集合的对象列表。
1、使用DataSet建立主从关系
主表和子表需要通过类型一致的主键、外键建立DataRelation，关系名称后续还要与GridControl中的层级名称保持一致。
①分别把主表和子表数据加载到同一个DataSet中。
②确认主表主键值与子表外键值能够对应，不能一个字段是整数，另一个字段是字符串。
③使用下面的方式建立关系：
④把GridControl绑定到主表：
gridControl1.DataSource=dataSet.Tables["Orders"];
⑤运行程序，检查主表行左侧是否出现展开按钮。
DataRelation中的名称就是GridControl识别明细层级的重要依据，后续创建层级节点时要继续使用OrderDetails。
2、使用实体类中的子集合
业务对象方案不需要单独建立DataRelation，但主对象必须公开一个保存明细记录的集合属性。
①在主实体中创建子集合，例如：
public BindingList
②查询数据时，把属于当前主记录的明细添加到Details中。
③将主对象列表绑定到GridControl：
gridControl1.DataSource=orderList;
④确认主视图的OptionsDetail.EnableMasterViewMode为true。
GridControl可以直接把IList类型的属性识别为明细关系。子属性只有IEnumerable或部分泛型集合接口时，需要在绑定数据前启用DataController.AllowIEnumerableDetails，否则展开后可能无法获得子记录。
3、创建并配置明细视图
自动生成的明细视图能够显示数据，但列宽、编辑器和显示格式通常需要单独设置。
①单击GridControl右上角的【智能标记】，进入【层级设计器】。
②点击【检索明细】，让设计器读取数据源中的主从关系。
③选择生成的关系节点，检查节点名称是否与DataRelation名称或子集合属性名完全一致。
④点击【更改视图】并创建新的GridView。
⑤打开【运行设计器】，选中明细GridView。
⑥进入【列】，点击【检索字段】，生成子表字段对应的列。
也可以通过代码关联层级和明细模板：
gridControl1.LevelTree.Nodes.Add("Details",detailView);
层级节点的RelationName负责匹配数据关系，LevelTemplate负责提供明细视图模板，两者缺少任何一项都会影响展开结果。
二、DevExpress GridControl主从数据展开后显示空白如何排查
出现空白后，先检查子集合和关系数据，再检查层级名称与明细列。不要一开始就反复删除GridView，否则可能掩盖真正的数据问题。
1、检查当前主行是否存在子数据
①在绑定GridControl前，检查子表行数或实体子集合的Count。
②随机选择一个主记录，核对其主键与子记录外键是否一致。
③确认子表查询已经执行，不能只加载主表后就立即绑定GridControl。
④调用IsMasterRowEmpty检查指定主行是否被GridControl判断为空。
⑤所有主行都为空时，回到数据查询和关系建立位置排查；只有个别主行为空时，重点检查对应外键值。
设计器中出现展开层级，只能说明关系结构已经建立，不能证明当前主记录一定存在子数据。
2、检查关系名称和层级节点
①打开【层级设计器】，记录当前节点的关系名称。
②核对DataRelation名称、子集合属性名和RelationName是否完全一致。
③检查ShowOnlyPredefinedDetails是否被设置为true。
④关系节点缺失时，重新点击【检索明细】，或者通过代码重新添加节点。
⑤临时把ShowOnlyPredefinedDetails改为false，重新运行并观察是否能由GridControl自动生成明细视图。
当ShowOnlyPredefinedDetails为true时，只有LevelTree中已经定义并正确匹配的关系才允许显示；关系名称不一致时，明细层级可能被直接忽略。
3、检查明细视图是否有可见列
子数据已经存在，但明细区域只有空白框或空表头时，通常要检查字段列。
①在【运行设计器】中选择明细GridView，不要误选主视图。
②进入【列】，确认列表中已经存在子表字段。
③没有字段时点击【检索字段】，或在绑定完成后调用：
detailView.PopulateColumns();
④检查每个列的FieldName是否与子表字段或实体属性完全一致。
⑤确认列的Visible为true，并且VisibleIndex没有全部设为负数。
AutoPopulateColumns关闭后，GridView不会自动为数据源字段创建列；字段已经变化时，原有列的FieldName不匹配也会导致单元格没有内容。
4、检查自定义事件是否返回了空集合
通过事件动态提供明细数据时，关系数量、关系名称和子集合必须同时返回正确结果。
①检查MasterRowGetRelationCount，确认有明细的主行返回值不是0。
②检查MasterRowGetRelationName，确认返回名称与LevelTree中的节点一致。
③检查MasterRowGetChildList，确认e.ChildList没有被赋值为null。
④确认返回对象实现了IList，并且集合中确实存在记录。
⑤处理事件时先确认RowHandle对应普通数据行，避免对分组行或无效行读取实体。
自定义明细模式中，ChildList就是当前展开视图使用的记录集合；该值为空时，即使关系名称和明细模板正确，展开区域仍然没有数据。
5、检查数据加载和刷新时机
①先完成主表、子表和关系初始化，再给DataSource赋值。
②子数据在后台加载完成后，调用gridControl1.RefreshDataSource()。
③折叠已经打开的明细行，再重新展开，避免继续使用旧的明细视图副本。
④使用普通List
⑤动态调整明细视图时，在ViewRegistered事件中取得实际生成的明细克隆视图。
GridControl展开主行时，会根据明细模板动态创建克隆视图，收起后再销毁。因此，运行时只修改错误的视图对象，也可能出现设置未生效或列仍为空的情况。
三、怎样让主从表配置更稳定
主从表完成后，应分别验证数据关系、明细模板和运行时克隆视图，避免后续更换数据源或字段后再次出现空白。
1、建立最小测试数据
①先准备两条主记录，每条主记录配置两条子记录。
②关闭筛选、分组和异步加载，只验证展开与显示。
③确认最小数据正常后，再接入数据库查询和复杂实体。
④增加日志，记录主键、子记录数量和实际关系名称。
2、检查运行时明细视图
①展开一条主记录。
②通过GetDetailView取得当前明细克隆视图。
③检查其RowCount、列数量和DataSource状态。
④需要保存明细编辑内容时，调用克隆视图的CloseEditor和UpdateCurrentRow。
明细克隆视图由GridControl在运行时动态创建，主视图、明细模板和实际展开视图不是同一个对象。区分三者后，列设置、事件绑定和数据更新会更容易定位。
总结
DevExpress GridControl主从表能否正常显示，取决于主从数据关系、关系名称、明细模板和子集合内容是否保持一致。展开后出现空白，多数不是控件本身失效，而是子数据未加载、层级名称不匹配、明细列未生成或动态事件返回了空集合。建立清晰的数据关系并分别检查主视图与明细视图，可以减少主从表开发中的重复排查。希望本文对大家配置和排查GridControl主从数据有所帮助，如需进一步了解相关软件，可联系咨询。
