ColumnView.SelectedRowsCount Property

Gets the number of selected rows (cards).

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

[Browsable(false)]
public virtual int SelectedRowsCount { get; }

VB.NET

<Browsable(False)>
Public Overridable ReadOnly Property SelectedRowsCount As Integer

Property Value

Type	Description
Int32	An integer value indicating the number of selected rows (cards).

Remarks

If a single row (card) is selected, the SelectedRowsCount property returns 1 and the selected row (card) matches the focused row (card). Thus, you can access the selected row’s handle using the ColumnView.FocusedRowHandle property. If the selected row is invalid, this method returns 0. Use the GridView.IsValidRowHandle method to identify whether the row is valid.

If several rows (cards) are selected, use the ColumnView.GetSelectedRows method to obtain the handles of the selected rows (cards).

Note that multiple row selection is allowed only when the ColumnViewOptionsSelection.MultiSelect property is set to true.

Note

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

Example

This example demonstrates how to obtain selected rows, and then change values of their “Discounted” column cells.

If Grid data is sorted or filtered, changes made to one Grid row can make other rows change their order and, as a result, their row handles. For that reason you cannot access selected rows by their handles and process these rows right away. Instead, pass row handles retrieved by ColumnView.GetSelectedRows method to the ColumnView.GetDataRow method. This allows you to access underlying data source objects (in this example, DataRows), save them to an array, and safely change their values afterwards.

Each row modification forces the Grid View to update itself. Enclose your code with the BaseView.BeginUpdate and BaseView.EndUpdate method calls to avoid excessive updates. Refer to the Batch Modifications Overview document for details.

C#

ArrayList rows = new ArrayList();

// Add the selected rows to the list.
Int32[] selectedRowHandles = gridView1.GetSelectedRows();
for (int i = 0; i < selectedRowHandles.Length; i++) {
    int selectedRowHandle = selectedRowHandles[i];
    if (selectedRowHandle >= 0)
        rows.Add(gridView1.GetDataRow(selectedRowHandle));
}
try {
    gridView1.BeginUpdate();
    for (int i = 0; i < rows.Count; i++) {
        DataRow row = rows[i] as DataRow;
        // Change the field value.
        row["Discontinued"] = true;
    }
}
finally {
    gridView1.EndUpdate();
}

VB.NET

Dim Rows As New ArrayList()

' Add the selected rows to the list.
Dim selectedRowHandles As Int32() = GridView1.GetSelectedRows()
Dim I As Integer
For I = 0 To selectedRowHandles.Length - 1
    Dim selectedRowHandle As Int32 = selectedRowHandles(I)
    If (selectedRowHandle >= 0) Then
        Rows.Add(GridView1.GetDataRow(selectedRowHandle))
    End If
Next
Try
    GridView1.BeginUpdate()
    For I = 0 To Rows.Count - 1
        Dim Row As DataRow = CType(Rows(I), DataRow)
        ' Change the field value.
        Row("Discontinued") = True
    Next
Finally
    GridView1.EndUpdate()
End Try

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SelectedRowsCount property.

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#

Reporting_report-server-how-to-manage-scheduled-jobs-from-a-windows-forms-application-t431255/CS/ScheduledTasksAPIClientDemo/MainForm.cs#L69

private void scheduledJobsView_FocusedRowChanged(object sender, DevExpress.XtraGrid.Views.Base.FocusedRowChangedEventArgs e) {
    showScheduledJobButton.Enabled = scheduledJobsView.SelectedRowsCount > 0;
    showScheduledJobResultsButton.Enabled = scheduledJobsView.SelectedRowsCount > 0;

Reporting_embedded-end-user-report-designer-demonstration-e20017/CS/Contacts/Controls/PersonListControl.cs#L56

{
    if (gridViewPerson.SelectedRowsCount == 1)
    {

how-to-change-checkstate-of-all-checkboxes-in-the-selected-rows-e1260/CS/Q146124/Form1.cs#L22

GridHitInfo hitInfo = view.CalcHitInfo(location);
return view.SelectedRowsCount > 1 && hitInfo.InRowCell && hitInfo.Column == colAllDay &&
    view.IsRowSelected(hitInfo.RowHandle);

how-to-get-the-gridview-selected-objects-e994/CS/WindowsApplication1/Form1.cs#L31

listBoxControl1.Items.Clear();
for(int i = 0; i < gridView1.SelectedRowsCount; i++) {
    int row = (gridView1.GetSelectedRows()[i]);

how-to-set-a-new-value-for-selected-cells-e718/CS/Form1.cs#L187

GridView view = gridView1;
if(barEditItem1.EditValue != null && view.SelectedRowsCount > 0)
    foreach(int row in view.GetSelectedRows()) {

VB.NET

Reporting_report-server-how-to-manage-scheduled-jobs-from-a-windows-forms-application-t431255/VB/ScheduledTasksAPIClientDemo/MainForm.vb#L69

Private Sub scheduledJobsView_FocusedRowChanged(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Base.FocusedRowChangedEventArgs) Handles scheduledJobsView.FocusedRowChanged
    showScheduledJobButton.Enabled = scheduledJobsView.SelectedRowsCount > 0
    showScheduledJobResultsButton.Enabled = scheduledJobsView.SelectedRowsCount > 0

Reporting_embedded-end-user-report-designer-demonstration-e20017/VB/Contacts/Controls/PersonListControl.vb#L64

Public Function Delete() As Integer Implements IControl.Delete
    If gridViewPerson.SelectedRowsCount = 1 Then
        Dim handle As Integer = gridViewPerson.GetDataSourceRowIndex(gridViewPerson.GetSelectedRows()(0))

how-to-change-checkstate-of-all-checkboxes-in-the-selected-rows-e1260/VB/Q146124/Form1.vb#L20

    Dim hitInfo As GridHitInfo = view.CalcHitInfo(location)
    Return view.SelectedRowsCount > 1 AndAlso hitInfo.InRowCell AndAlso hitInfo.Column Is colAllDay AndAlso view.IsRowSelected(hitInfo.RowHandle)
End Function

how-to-get-the-gridview-selected-objects-e994/VB/WindowsApplication1/Form1.vb#L33

listBoxControl1.Items.Clear()
For i As Integer = 0 To gridView1.SelectedRowsCount - 1
    Dim row As Integer = (gridView1.GetSelectedRows()(i))

how-to-set-a-new-value-for-selected-cells-e718/VB/Form1.vb#L175

Dim view As GridView = gridView1
If barEditItem1.EditValue IsNot Nothing AndAlso view.SelectedRowsCount > 0 Then
    For Each row As Integer In view.GetSelectedRows()