DataGridView.SelectedRows Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um DataGridViewSelectedRowCollection que contém as linhas selecionadas pelo usuário.
- Atributos
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 true
como Selected .