DataGridView.SelectedRows Propiedad

Definición

Obtiene la colección de filas seleccionadas por el usuario.Gets the collection of rows selected by the user.

public:
 property System::Windows::Forms::DataGridViewSelectedRowCollection ^ SelectedRows { System::Windows::Forms::DataGridViewSelectedRowCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewSelectedRowCollection SelectedRows { get; }
[<System.ComponentModel.Browsable(false)>]
member this.SelectedRows : System.Windows.Forms.DataGridViewSelectedRowCollection
Public ReadOnly Property SelectedRows As DataGridViewSelectedRowCollection

Valor de propiedad

DataGridViewSelectedRowCollection

Colección DataGridViewSelectedRowCollection que contiene las filas seleccionadas por el usuario.A DataGridViewSelectedRowCollection that contains the rows selected by the user.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar la SelectedRows propiedad en el UserDeletingRow evento.The following code example demonstrates how to use the SelectedRows property in the UserDeletingRow event. En este ejemplo, si la primera fila se encuentra en la SelectedRows colección, se cancela la eliminación.In this example, if the first row is contained in the SelectedRows collection, then the deletion is canceled. Este ejemplo forma parte de un ejemplo más grande disponible en el SelectionChanged evento.This example is part of a larger example available in the SelectionChanged event.

private void DataGridView1_UserDeletingRow(object sender,
    DataGridViewRowCancelEventArgs e)
{
    DataGridViewRow startingBalanceRow = DataGridView1.Rows[0];

    // Check if the Starting Balance row is included in the selected rows
    if (DataGridView1.SelectedRows.Contains(startingBalanceRow))
    {
        // Do not allow the user to delete the Starting Balance row.
        MessageBox.Show("Cannot delete Starting Balance row!");

        // Cancel the deletion if the Starting Balance row is included.
        e.Cancel = true;
    }
}
Private Sub UserDeletingRow(ByVal sender As Object, _
    ByVal e As DataGridViewRowCancelEventArgs) _
    Handles DataGridView1.UserDeletingRow

    Dim startingBalanceRow As DataGridViewRow = DataGridView1.Rows(0)

    ' Check if the starting balance row is included in the selected rows
    If DataGridView1.SelectedRows.Contains(startingBalanceRow) Then
        ' Do not allow the user to delete the Starting Balance row.
        MessageBox.Show("Cannot delete Starting Balance row!")

        ' Cancel the deletion if the Starting Balance row is included.
        e.Cancel = True
    End If
End Sub

Comentarios

La SelectionMode propiedad se debe establecer en FullRowSelect o RowHeaderSelect para SelectedRows que la propiedad se rellene con las filas seleccionadas.The SelectionMode property must be set to FullRowSelect or RowHeaderSelect for the SelectedRows property to be populated with selected rows.

Esta propiedad contiene una instantánea de solo lectura de la selección en el momento en que se hace referencia a ella.This property contains a read-only snapshot of the selection at the time it is referenced. Si mantiene una copia de esta colección, puede diferir del estado real y subsiguiente en el DataGridView que el usuario puede haber cambiado la selección.If you hold onto a copy of this collection, it may differ from the actual, subsequent DataGridView state in which the user may have changed the selection. Por lo tanto, no debe operar en una copia de la colección.You should therefore not operate on a copy of the collection.

Para seleccionar una fila mediante programación, establezca su Selected propiedad en true .To programmatically select a row, set its Selected property to true.

Se aplica a

Consulte también