ColumnView.GetRow(Int32) Method

Returns an object that represents the row in a Grid data source.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.2.dll

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 representing the desired row handle.

Returns

Type	Description
Object	An object representing a specific row.

Remarks

This method’s return value depends on the data source type. If a data source is a DataTable or a DataView, this method returns a DataRowView object. If the data source is a custom list of items, the appropriate list item is returned.

For group rows, the GetRow function returns an object that represents the first data row in the associated group.

Note

In Instant Feedback Mode, the GetRow method returns:

• a DevExpress.Data.NotLoadedObject object, if a row is not yet loaded;
• an object the GridControl uses to retrieve row values, if a row is ready.

To identify whether a row has been loaded, call the ColumnView.IsRowLoaded method.

It is recommended that you use the ColumnView.GetRowCellValue method to retrieve row values in Instant Feedback Mode.

See the Accessing Rows in Code. Row Handles section in the Rows topic for more information.

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 real Views that are displayed within the Grid Control. The real Views with which an end-user interacts at runtime can be accessed using the following methods.

• 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.

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#

mvvmexpenses-sample-application-t254492/CS/MVVMExpenses/Views/Account/AccountsView.cs#L45

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

gridlookupedit-multiple-selection-web-style-with-the-ok-cancel-buttons-e4048/CS/GridLookUpEditCBMultipleSelection/GridCheckMarksSelection.cs#L81

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

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

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

XPO_how-to-view-persistent-objects-in-the-xtragrid-and-edit-them-in-a-separate-window-e771/CS/FormViewOrders.cs#L25

if(rowHandle < 0) return;
Order theOrder = (Order)gridView1.GetRow(rowHandle);
EditOrder(theOrder);

a-master-detail-grid-with-entity-framework-objects-e417/CS/CS/Entities/Form1.cs#L26

GridView view = sender as GridView;
Customers c = (Customers)view.GetRow(e.RowHandle);
e.IsEmpty = c.Orders.Count == 0;

VB.NET

mvvmexpenses-sample-application-t254492/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

gridlookupedit-multiple-selection-web-style-with-the-ok-cancel-buttons-e4048/VB/GridLookUpEditCBMultipleSelection/GridCheckMarksSelection.vb#L89

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

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

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

a-master-detail-grid-with-entity-framework-objects-e417/VB/CS/Entities/Form1.vb#L27

Private Sub gridView1_MasterRowEmpty(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Grid.MasterRowEmptyEventArgs) Handles gridView1.MasterRowEmpty
    Dim c As Customers = CType(gridView1.GetRow(e.RowHandle), Customers)
    e.IsEmpty = c.Orders.Count = 0

how-to-display-ef-objects-in-a-grid-within-master-detail-mode-when-entities-have-many-to-man-e2766/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