DataGridView.SelectedRows Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém a coleção de linhas selecionada pelo utilizador.
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.DataGridViewSelectedRowCollectionPublic ReadOnly Property SelectedRows As DataGridViewSelectedRowCollectionValor de Propriedade
A DataGridViewSelectedRowCollection que contém as linhas selecionadas pelo utilizador.
- Atributos
Exemplos
O seguinte exemplo de código demonstra como usar a SelectedRows propriedade no UserDeletingRow evento. Neste exemplo, se a primeira linha estiver contida na SelectedRows coleção, então a eliminação é 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
Observações
A SelectionMode propriedade deve ser definida para FullRowSelect ou RowHeaderSelect para que a SelectedRows propriedade seja preenchida com linhas selecionadas.
Esta propriedade contém um instantâneo apenas de leitura da seleção no momento em que é referenciada. Se guardar uma cópia desta coleção, pode diferir do estado real e subsequente DataGridView em que o utilizador pode ter alterado a seleção. Por isso, não deve operar numa cópia da coleção.
Para selecionar programaticamente uma linha, defina a sua Selected propriedade para true.