DataGridView.CancelRowEdit Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ocorre quando a propriedade VirtualMode de um controle DataGridView é true e o usuário cancela edições em uma linha.

public:
 event System::Windows::Forms::QuestionEventHandler ^ CancelRowEdit;

public event System.Windows.Forms.QuestionEventHandler CancelRowEdit;

member this.CancelRowEdit : System.Windows.Forms.QuestionEventHandler 

Public Custom Event CancelRowEdit As QuestionEventHandler 

Tipo de evento

QuestionEventHandler

Exemplos

O exemplo de código a seguir ilustra como lidar com esse evento para um controle DataGridView no modo virtual. Quando o controle está no modo de edição, a variável rowInEdit mantém o índice da linha que está sendo editada e a variável customerInEdit mantém uma referência a um objeto Customer correspondente a essa linha. Quando o usuário cancela o modo de edição, esse objeto pode ser descartado. Se a linha que o usuário estava editando for a linha para novos registros, no entanto, o objeto Cliente antigo será descartado e substituído por um novo para que o usuário possa começar a fazer edições novamente. Este exemplo faz parte de um exemplo maior disponível em Passo a passo: implementando o modo virtual no controle DataGridView do Windows Forms.

void dataGridView1_CancelRowEdit( Object^ /*sender*/,
    System::Windows::Forms::QuestionEventArgs^ /*e*/ )
{
   if ( this->rowInEdit == this->dataGridView1->Rows->Count - 2 &&
        this->rowInEdit == this->customers->Count )
   {
      
      // If the user has canceled the edit of a newly created row, 
      // replace the corresponding Customer object with a new, empty one.
      this->customerInEdit = gcnew Customer;
   }
   else
   {
      
      // If the user has canceled the edit of an existing row, 
      // release the corresponding Customer object.
      this->customerInEdit = nullptr;
      this->rowInEdit = -1;
   }
}

private void dataGridView1_CancelRowEdit(object sender,
    System.Windows.Forms.QuestionEventArgs e)
{
    if (this.rowInEdit == this.dataGridView1.Rows.Count - 2 &&
        this.rowInEdit == this.customers.Count)
    {
        // If the user has canceled the edit of a newly created row, 
        // replace the corresponding Customer object with a new, empty one.
        this.customerInEdit = new Customer();
    }
    else
    {
        // If the user has canceled the edit of an existing row, 
        // release the corresponding Customer object.
        this.customerInEdit = null;
        this.rowInEdit = -1;
    }
}

Private Sub dataGridView1_CancelRowEdit(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.QuestionEventArgs) _
    Handles dataGridView1.CancelRowEdit

    If Me.rowInEdit = Me.dataGridView1.Rows.Count - 2 AndAlso _
        Me.rowInEdit = Me.customers.Count Then

        ' If the user has canceled the edit of a newly created row, 
        ' replace the corresponding Customer object with a new, empty one.
        Me.customerInEdit = New Customer()

    Else

        ' If the user has canceled the edit of an existing row, 
        ' release the corresponding Customer object.
        Me.customerInEdit = Nothing
        Me.rowInEdit = -1

    End If

End Sub

Comentários

Quando o DataGridView está no modo virtual, as alterações são confirmadas no cache de dados no nível da célula por padrão. O evento CancelRowEdit pode ser usado ao implementar transações de nível de linha.

Para obter mais informações sobre como lidar com eventos, consulte manipulação e geração de eventos.

Confira também

• controle DataGridView (Windows Forms)