ColumnView.GetRow(Int32) Method

Returns an Object in the bound data source that contains data for the specified grid row.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

public override object GetRow(
    int rowHandle
)

VB.NET

Public Overrides Function GetRow(
    rowHandle As Integer
) As Object

Parameters

Name	Type	Description
rowHandle	Int32	An integer value that specifies a grid row’s handle. Note that grid rows and their handles are not equal to data rows and their indexes in the bound data source.

Returns

Type	Description
Object	An object that specifies a row of data in a data source.

Remarks

Use the following methods to get an object that contains data for a specific node:

• GetRow(Int32) — Returns an Object in the bound data source that contains data for the specified grid row.

  To get the focused grid row’s data row, use the GetFocusedRow() method.

• GetDataRow(Int32) — Returns a DataRow in the bound DataTable that contains data for the specified grid row.

  To get the focused grid row’s DataRow, use the GetFocusedDataRow() method.

  Note

  If the bound data source is a custom collection, these methods return null (Nothing in VB).

To specify the row in the method’s parameter, use the row’s handle.

For a group row, these methods return the first grid row’s underlying data row.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the GetRow member must not be invoked for these Views. The GetRow member can only be used with Views that display real data within the Grid Control. Use the following methods to access these Views with which an end user interacts at runtime.

• GridControl.MainView - returns the top most View in a grid;
• GridControl.FocusedView - returns the focused View;
• GridControl.DefaultView - returns the currently maximized View;
• the sender parameter of View specific events;
• GridView.GetDetailView - returns a detail clone View for a specific master row.

Instant Feedback Mode

In Instant Feedback Mode, the grid control gets records from a data source in asynchronous mode without freezing the UI.

A grid row’s data may not have been loaded yet when you try to get an underlying data record. Before you call the GetRow(Int32) method in this mode, use the IsRowLoaded(Int32) method to check if a row is already loaded. If a row is not loaded, the GetRow(Int32) returns a DevExpress.Data.NotLoadedObject.

Tip

In Instant Feedback mode, use the GetRowCellValue method to get cell values.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GetRow(Int32) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-mvvm-expenses-app/CS/MVVMExpenses/Views/Account/AccountsView.cs#L45

IEnumerable<MVVMExpenses.DataModels.Account> GetSelectedAccounts() {
    return gridView1.GetSelectedRows().Select(r => gridView1.GetRow(r) as MVVMExpenses.DataModels.Account);
}

winforms-grid-multiple-row-selection-web-style-checkboxes/CS/E1271/CheckMarkSelection.cs#L64

for(int i = 0; i < _view.DataRowCount; i++)
    selection.Add(_view.GetRow(i));
Invalidate();

winforms-grid-master-detail-entity-framework/CS/Entities/Form1.cs#L18

private void OnMasterRowEmpty(object sender, DevExpress.XtraGrid.Views.Grid.MasterRowEmptyEventArgs e) {
    Product p = (Product)gridView1.GetRow(e.RowHandle);
    e.IsEmpty = p.Order_Details.Count == 0;

winforms-grid-enable-server-mode-for-detail-view/CS/Q205267_4/Form1.cs#L43

GridView view = (GridView)sender;
Employees employee = (Employees)view.GetRow(e.RowHandle);
XPServerCollectionSource source = CreateChildServerModeSource(employee);

winforms-diagram-create-custom-toolbox/CS/CustomDiagramToolboxExample/Form1.cs#L36

{
    DiagramShape shapeItem = gridView1.GetRow(e.RowHandle) as DiagramShape;
    if (shapeItem == null)

VB.NET

winforms-mvvm-expenses-app/VB/MVVMExpenses/Views/Account/AccountsView.vb#L41

Private Function GetSelectedAccounts() As IEnumerable(Of MVVMExpenses.DataModels.Account)
    Return gridView1.GetSelectedRows().Select(Function(r) TryCast(gridView1.GetRow(r), MVVMExpenses.DataModels.Account))
End Function

winforms-grid-multiple-row-selection-web-style-checkboxes/VB/E1271/CheckMarkSelection.vb#L85

For i As Integer = 0 To _view.DataRowCount - 1
    selection.Add(_view.GetRow(i))
Next

winforms-grid-master-detail-entity-framework/VB/Entities/Form1.vb#L20

Private Sub OnMasterRowEmpty(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Grid.MasterRowEmptyEventArgs) Handles gridView1.MasterRowEmpty
    Dim p As Product = CType(gridView1.GetRow(e.RowHandle), Product)
    e.IsEmpty = p.Order_Details.Count = 0

winforms-grid-enable-server-mode-for-detail-view/VB/Q205267_4/Form1.vb#L39

Dim view As GridView = CType(sender, GridView)
Dim employee As Employees = CType(view.GetRow(e.RowHandle), Employees)
Dim source As XPServerCollectionSource = CreateChildServerModeSource(employee)

winforms-diagram-create-custom-toolbox/VB/CustomDiagramToolboxExample/Form1.vb#L39

Private Sub GridView1_CustomDrawCell(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Base.RowCellCustomDrawEventArgs)
    Dim shapeItem As DevExpress.XtraDiagram.DiagramShape = TryCast(Me.gridView1.GetRow(e.RowHandle), DevExpress.XtraDiagram.DiagramShape)
    If shapeItem Is Nothing Then Return