Propriedade EditMode

Indica o status de edição do registro atual.

Valor retornado

Retorna um valor EditModeEnum.

Observações

O ADO mantém um buffer de edição associado ao registro atual. Essa propriedade indica se foram feitas alterações nesse buffer ou se um novo registro foi criado. Use a propriedade EditMode para determinar o status de edição do registro atual. Você pode testar alterações pendentes se um processo de edição tiver sido interrompido e determinar se você precisa usar o método Update ou CancelUpdate.

Em modo de atualização imediata a propriedade EditMode é redefinida para adEditNone depois que uma chamada bem-sucedida para o método Update é chamada. Quando uma chamada para Excluir não exclui com êxito o registro ou registros na fonte de dados (por exemplo, devido a violações de integridade referencial), o Recordset permanece no modo de edição (EditMode = adEditInProgress). Portanto, CancelUpdate deve ser chamado antes de sair do registro atual (por exemplo, com Move, NextRecordsetou Close).

Em modo de atualização em lote (no qual o provedor armazena várias alterações em cache e as grava na fonte de dados subjacente somente quando você chama o método UpdateBatch), o valor da propriedade EditMode é alterado quando a primeira operação é executada e não é redefinida por uma chamada para o método Update. As operações subsequentes não alteram o valor da propriedade EditMode, mesmo que diferentes operações sejam executadas. Por exemplo, se a primeira operação for adicionar um novo registro e a segunda fizer alterações em um registro existente, a propriedade de EditMode ainda será adEditAdd. A propriedade EditMode não é redefinida para adEditNone até depois da chamada para UpdateBatch. Para determinar quais operações foram executadas, defina a propriedade Filter como adFilterPending para que apenas registros com alterações pendentes fiquem visíveis e examinem a propriedade Status de cada registro para determinar quais alterações foram feitas nos dados.

Nota

EditMode só poderá retornar um valor válido se houver um registro atual. EditMode retornará um erro se BOF ou EOF for verdadeiro ou se o registro atual tiver sido excluído.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

exemplo das propriedades CursorType, LockType e EditMode (VB)
exemplo das propriedades CursorType, LockType e EditMode (VC++)
método AddNew (ADO)
do Método de Exclusão (Conjunto de Registros do ADO)
método CancelUpdate (ADO)
método Update