DataGridView.CancelRowEdit Событие

Определение

Происходит, когда свойство VirtualMode элемента управления DataGridView имеет значение true, и отменяет изменения в строке.Occurs when the VirtualMode property of a DataGridView control is true and the cancels edits in a row.

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 

Тип события

QuestionEventHandler

Примеры

В следующем примере кода показано, как справиться с этим событием для DataGridView элемента управления в виртуальном режиме.The following code example illustrates how to handle this event for a DataGridView control in virtual mode. Если элемент управления находится в режиме редактирования, rowInEdit переменная содержит индекс редактируемой строки, а customerInEdit переменная содержит ссылку на объект Customer, соответствующий этой строке.When the control is in edit mode, the rowInEdit variable holds the index of the row being edited, and the customerInEdit variable holds a reference to a Customer object corresponding to that row. Когда пользователь отменяет режим редактирования, этот объект может быть отклонен.When the user cancels out of edit mode, this object can be discarded. Однако если строка, измененная пользователем, является строкой для новых записей, старый объект Customer удаляется и заменяется новым, чтобы пользователь мог снова начать внесение изменений.If the row the user was editing is the row for new records, however, the old Customer object is discarded and replaced with a new one so that the user can begin making edits again. Этот пример является частью большого примера, доступного в разделе Пошаговое руководство. Реализация виртуального режима в элементе управления Windows Forms DataGridView.This example is part of a larger example available in Walkthrough: Implementing Virtual Mode in the Windows Forms DataGridView Control.

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

Комментарии

Если параметр DataGridView находится в виртуальном режиме, по умолчанию изменения фиксируются в кэше данных на уровне ячейки.When the DataGridView is in virtual mode, changes are committed to the data cache at the cell level by default. CancelRowEditСобытие может использоваться при реализации транзакций на уровне строк.The CancelRowEdit event can be used when implementing row-level transactions.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about how to handle events, see Handling and Raising Events.

Применяется к