DataGridView.SelectedRows Propriété

Définition

Obtient la collection des lignes sélectionnées par l’utilisateur.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; }
member this.SelectedRows : System.Windows.Forms.DataGridViewSelectedRowCollection
Public ReadOnly Property SelectedRows As DataGridViewSelectedRowCollection

Valeur de propriété

DataGridViewSelectedRowCollection qui représente les lignes sélectionnées par l'utilisateur.A DataGridViewSelectedRowCollection that contains the rows selected by the user.

Attributs

Exemples

L’exemple de code suivant montre comment utiliser la propriété SelectedRows dans l’événement UserDeletingRow.The following code example demonstrates how to use the SelectedRows property in the UserDeletingRow event. Dans cet exemple, si la première ligne est contenue dans la collection SelectedRows, la suppression est annulée.In this example, if the first row is contained in the SelectedRows collection, then the deletion is canceled. Cet exemple fait partie d’un exemple plus complet disponible dans l’événement SelectionChanged.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

Remarques

La propriété SelectionMode doit avoir la valeur FullRowSelect ou RowHeaderSelect pour que la propriété SelectedRows soit remplie avec les lignes sélectionnées.The SelectionMode property must be set to FullRowSelect or RowHeaderSelect for the SelectedRows property to be populated with selected rows.

Cette propriété contient un instantané en lecture seule de la sélection au moment où elle est référencée.This property contains a read-only snapshot of the selection at the time it is referenced. Si vous conservez une copie de cette collection, elle peut être différente de l’état réel, DataGridView, suivant, dans lequel l’utilisateur peut avoir modifié la sélection.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. Par conséquent, vous ne devez pas utiliser une copie de la collection.You should therefore not operate on a copy of the collection.

Pour sélectionner une ligne par programmation, affectez à sa propriété Selected la valeur true.To programmatically select a row, set its Selected property to true.

S’applique à

Voir aussi