C#中GetFocusedRow返回null的原因？

Question

在使用 DevExpress WinForms 控件时，C# 中 `GridView.GetFocusedRow()` 返回 `null` 是一个常见问题。主要原因包括：当前视图未聚焦任何行、数据源为空或未正确绑定、网格初始加载时尚未完成 UI 更新导致焦点行不可用。此外，若启用了分组或过滤，且可见行中无有效焦点，也会返回 `null`。调用时机不当（如在 `FormLoad` 事件中过早调用）同样会导致此现象。建议在确保网格已绑定且用户已交互后再调用该方法，并检查 `FocusedRowHandle` 是否有效（如不等于 `InvalidRowHandle`），以避免空引用异常。

Answer 1

DevExpress WinForms 中 GridView.GetFocusedRow() 返回 null 的深度解析与实战应对

1. 问题现象与初步诊断

在使用 DevExpress WinForms 控件开发桌面应用时，GridView.GetFocusedRow() 方法返回 null 是一个高频出现的技术痛点。开发者常在尝试获取当前选中行数据时遭遇此问题，进而引发 NullReferenceException。

• 现象：调用 GetFocusedRow() 后返回 null，但界面显示存在数据行。
• 典型场景：窗体加载初期、用户尚未交互、数据绑定未完成。
• 初步判断：焦点未正确设置或视图状态未就绪。

2. 核心原因分析（由浅入深）

以下为导致 GetFocusedRow() 返回 null 的五大主因，按执行顺序递进：

1. 调用时机过早：在 FormLoad 或 DataBindingComplete 之前调用，UI 线程尚未完成布局渲染。
2. 数据源异常：绑定的数据源为空、未实例化或未正确赋值给 GridControl.DataSource。
3. 焦点未分配：即使有数据，若 GridView 未获得输入焦点或未设置默认选中行，FocusedRowHandle 可能为 InvalidRowHandle。
4. 过滤或分组影响：启用过滤后，所有行被隐藏；分组状态下无展开项，导致可视行集合为空。
5. 多线程操作冲突：异步加载数据时未通过 Invoke 回主线程更新 UI，造成状态不一致。

3. 检测与验证流程图

        graph TD
            A[开始调用 GetFocusedRow] --> B{GridView 是否已绑定数据?}
            B -- 否 --> C[返回 null]
            B -- 是 --> D{FocusedRowHandle == InvalidRowHandle?}
            D -- 是 --> E[检查是否有可见行]
            D -- 否 --> F[正常获取行对象]
            E --> G{VisibleRowCount > 0?}
            G -- 否 --> H[应用过滤/分组导致无可见行]
            G -- 是 --> I[尝试 SetFocusedRowHandle(0)]
            I --> J[重新调用 GetFocusedRow]
            J --> K[返回结果]
    

4. 常见错误代码示例与修正对比

场景	错误写法	正确做法
FormLoad 中直接调用	private void Form1_Load(...) { var row = gridView1.GetFocusedRow(); }	延迟至 Shown 事件或用户交互触发
未检查焦点句柄	var data = (MyEntity)gridView1.GetFocusedRow();	if (gridView1.FocusedRowHandle != InvalidRowHandle) { ... }
异步加载未同步	后台线程直接绑定 DataSource	使用 this.Invoke() 安全更新 UI
忽略过滤状态	假设所有行都可聚焦	调用 GetVisibleRowHandle(0) 获取首个可见行

5. 推荐解决方案与最佳实践

为确保稳健性，应遵循以下编码规范：

// 示例：安全获取焦点行
private object SafeGetFocusedRow()
{
    if (gridView1 == null || !gridView1.IsHandleCreated)
        return null;

    if (gridView1.RowCount == 0)
        return null;

    if (gridView1.FocusedRowHandle == DevExpress.XtraGrid.GridControl.InvalidRowHandle)
    {
        // 尝试定位第一个可见行
        int firstVisible = gridView1.GetVisibleRowHandle(0);
        if (firstVisible != DevExpress.XtraGrid.GridControl.InvalidRowHandle)
            gridView1.FocusedRowHandle = firstVisible;
        else
            return null;
    }

    return gridView1.GetFocusedRow();
}
    

此外，建议监听 FocusedRowChanged 事件以动态响应用户行为，并结合 SelectionChanged 提升交互体验。

6. 高级调试技巧

对于复杂场景，可借助以下手段深入排查：

• 使用 OutputDebugString 输出 FocusedRowHandle、RowCount、VisibleRowCount 等关键指标。
• 通过 SuspendLayout/ResumeLayout 控制布局时机，避免中间状态干扰。
• 启用 DevExpress 内置日志：Tracing.SetFileLogging(true); 跟踪内部事件流。
• 利用 WinForms Designer 查看器验证 DataSource 绑定路径是否正确。
• 模拟用户操作（如 SendKeys）测试焦点恢复逻辑。
• 在 MVVM 架构中，通过命令参数传递 SelectedItems 而非依赖视图主动查询。
• 对分组视图，使用 GetRow(treeNode.NodeRowHandle) 替代直接焦点访问。
• 设置默认聚焦策略：gridView1.OptionsNavigation.EnterMoveNextColumn = true;
• 启用自动聚焦：gridView1.Focus(); gridView1.FocusedColumn = gridView1.Columns[0];
• 处理虚拟模式下的特殊逻辑，避免缓存未加载行数据。