DataGridView.SelectedRows Właściwość

Definicja

Pobiera kolekcję wierszy wybranych przez użytkownika.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

Wartość właściwości

DataGridViewSelectedRowCollection

A DataGridViewSelectedRowCollection , który zawiera wiersze wybrane przez użytkownika.A DataGridViewSelectedRowCollection that contains the rows selected by the user.

Atrybuty

Przykłady

Poniższy przykład kodu demonstruje, jak używać SelectedRows właściwości w UserDeletingRow zdarzeniu.The following code example demonstrates how to use the SelectedRows property in the UserDeletingRow event. W tym przykładzie, jeśli pierwszy wiersz jest zawarty w SelectedRows kolekcji, usuwanie zostanie anulowane.In this example, if the first row is contained in the SelectedRows collection, then the deletion is canceled. Ten przykład jest częścią większego przykładu dostępnego w SelectionChanged zdarzeniu.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

Uwagi

SelectionModeWłaściwość musi być ustawiona na wartość FullRowSelect lub RowHeaderSelect , aby SelectedRows Właściwość była wypełniana wybranymi wierszami.The SelectionMode property must be set to FullRowSelect or RowHeaderSelect for the SelectedRows property to be populated with selected rows.

Ta właściwość zawiera migawkę wybraną tylko do odczytu w czasie, w którym jest przywoływany.This property contains a read-only snapshot of the selection at the time it is referenced. Jeśli zatrzymasz się na kopii tej kolekcji, może ona różnić się od rzeczywistego, kolejnego DataGridView stanu, w którym użytkownik mógł zmienić zaznaczenie.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. W związku z tym nie należy wykonywać operacji na kopii kolekcji.You should therefore not operate on a copy of the collection.

Aby programowo zaznaczyć wiersz, ustaw jego Selected Właściwość na true .To programmatically select a row, set its Selected property to true.

Dotyczy

Zobacz też