DataGridView.SelectedRows DataGridView.SelectedRows DataGridView.SelectedRows DataGridView.SelectedRows Property

Definition

Ruft die Auflistung der ausgewählten Zeilen ab.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

Eigenschaftswert

Beispiele

Im folgenden Codebeispiel wird die Verwendung der SelectedRows -Eigenschaft UserDeletingRow im-Ereignis veranschaulicht.The following code example demonstrates how to use the SelectedRows property in the UserDeletingRow event. Wenn die erste Zeile in diesem Beispiel in der SelectedRows Auflistung enthalten ist, wird der Löschvorgang abgebrochen.In this example, if the first row is contained in the SelectedRows collection, then the deletion is canceled. Dieses Beispiel ist Teil eines größeren Beispiels, das SelectionChanged im Ereignis verfügbar ist.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

Hinweise

Die SelectionMode -Eigenschaft muss auf FullRowSelect oder RowHeaderSelect festgelegt werden SelectedRows , damit die-Eigenschaft mit den ausgewählten Zeilen aufgefüllt wird.The SelectionMode property must be set to FullRowSelect or RowHeaderSelect for the SelectedRows property to be populated with selected rows.

Diese Eigenschaft enthält eine schreibgeschützte Momentaufnahme der Auswahl, wenn auf Sie verwiesen wird.This property contains a read-only snapshot of the selection at the time it is referenced. Wenn Sie eine Kopie dieser Sammlung aufbewahren, kann Sie sich vom tatsächlichen, nachfolgenden DataGridView Zustand unterscheiden, in dem der Benutzer die Auswahl möglicherweise geändert hat.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. Daher sollten Sie nicht mit einer Kopie der Sammlung arbeiten.You should therefore not operate on a copy of the collection.

Um eine Zeile Programm gesteuert auszuwählen, legen Sie Selected die zugehörige-Eigenschaft auf truefest.To programmatically select a row, set its Selected property to true.

Gilt für:

Siehe auch