ColumnView.GetDataSourceRowIndex(Int32) Method

Returns the index of the data source record that corresponds to the specified row handle.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v22.2.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

public int GetDataSourceRowIndex(
    int rowHandle
)

VB.NET

Public Function GetDataSourceRowIndex(
    rowHandle As Integer
) As Integer

Parameters

Name	Type	Description
rowHandle	Int32	An integer value representing the row handle.

Returns

Type	Description
Int32	The zero-based index of the data record to which the specified row handle corresponds.

Remarks

See the Accessing Rows in Code. Row Handles section in the Rows topic for information on row handles.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the GetDataSourceRowIndex member must not be invoked for these Views. The GetDataSourceRowIndex 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.

Example

The following example handles the GridView.CustomDrawRowIndicator event to display data source row indexes in the Row Indicator Panel.

C#

using DevExpress.XtraGrid;
using DevExpress.XtraGrid.Views.Grid;

public partial class Form1 : Form {
    public Form1() {
        InitializeComponent();

        GridControl gridControl1 = new GridControl { Parent = this, Dock = DockStyle.Fill };
        GridView gridView1 = new GridView();
        gridControl1.MainView = gridView1;
        gridView1.OptionsBehavior.Editable = false;

        Random r = new Random();
        List<MyObject> dataSource = new List<MyObject>();
        for (int i = 0; i < 5; i++) 
            dataSource.Add(new MyObject { Id = r.Next(0, 100), Name = string.Format("Name {0}", i) });
        gridControl1.DataSource = dataSource;

        gridView1.Columns["Id"].SortOrder = DevExpress.Data.ColumnSortOrder.Descending;
        gridView1.CustomDrawRowIndicator += gridView_CustomDrawRowIndicator;
        gridView1.IndicatorWidth = 30;
    }

    void gridView_CustomDrawRowIndicator(object sender, RowIndicatorCustomDrawEventArgs e) {
        if (!e.Info.IsRowIndicator) return;
        GridView view = sender as GridView;
        int dataSourceRowIndex = view.GetDataSourceRowIndex(e.RowHandle);
        e.Info.DisplayText = dataSourceRowIndex.ToString();
    }

    public class MyObject {
        public int Id { get; set; }
        public string Name { get; set; }
    }
}

VB.NET

Imports DevExpress.XtraGrid
Imports DevExpress.XtraGrid.Views.Grid

Partial Public Class Form1
    Public Sub New()
        InitializeComponent()

        Dim gridControl1 As GridControl = New GridControl With {
            .Parent = Me,
            .Dock = DockStyle.Fill
        }
        Dim gridView1 As GridView = New GridView()
        gridControl1.MainView = gridView1
        gridView1.OptionsBehavior.Editable = False
        Dim r As Random = New Random()
        Dim dataSource As List(Of MyObject) = New List(Of MyObject)()

        For i As Integer = 0 To 4
            dataSource.Add(New MyObject With {
                .Id = r.[Next](0, 100),
                .Name = String.Format("Name {0}", i)
            })
        Next

        gridControl1.DataSource = dataSource
        gridView1.Columns("Id").SortOrder = DevExpress.Data.ColumnSortOrder.Descending
        AddHandler gridView1.CustomDrawRowIndicator, AddressOf gridView_CustomDrawRowIndicator
        gridView1.IndicatorWidth = 30
    End Sub

    Private Sub gridView_CustomDrawRowIndicator(ByVal sender As Object, ByVal e As RowIndicatorCustomDrawEventArgs)
        If Not e.Info.IsRowIndicator Then Return
        Dim view As GridView = TryCast(sender, GridView)
        Dim dataSourceRowIndex As Integer = view.GetDataSourceRowIndex(e.RowHandle)
        e.Info.DisplayText = dataSourceRowIndex.ToString()
    End Sub
End Class

Public Class MyObject
    Public Property Id As Integer
    Public Property Name As String
End Class