DataGridView.SelectedRows Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém a coleção de linhas selecionadas pelo usuário.

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 da propriedade

DataGridViewSelectedRowCollection

Um DataGridViewSelectedRowCollection que contém as linhas selecionadas pelo usuário.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar a SelectedRows propriedade no UserDeletingRow evento . Neste exemplo, se a primeira linha estiver contida na SelectedRows coleção, a exclusão será cancelada. Este exemplo faz parte de um exemplo maior disponível no SelectionChanged evento.

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

Comentários

A SelectionMode propriedade deve ser definida FullRowSelect como ou RowHeaderSelect para que a SelectedRows propriedade seja preenchida com linhas selecionadas.

Essa propriedade contém uma instantâneo somente leitura da seleção no momento em que é referenciada. Se você mantiver uma cópia dessa coleção, ela poderá ser diferente do estado real e subsequente DataGridView em que o usuário pode ter alterado a seleção. Portanto, você não deve operar em uma cópia da coleção.

Para selecionar programaticamente uma linha, defina sua propriedade truecomo Selected .

Confira também

• Selected
• Controle DataGridView (Windows Forms)