Propriedade EditMode

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

Valor Retornado

Retorna um valor EditModeEnum.

Comentários

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 registro foi criado. Use a propriedade EditMode para determinar o status de edição do registro atual. Você pode testar as alterações pendentes se um processo de edição foi interrompido e determinar se você precisa usar o método Update ou CancelUpdate.

No modo de atualização imediata, a propriedade EditMode é redefinida para adEditNone depois que uma chamada bem-sucedida ao método Update é feita. Quando uma chamada a Delete não exclui com sucesso os 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, NextRecordset ou Close).

No modo de atualização em lote (no qual o provedor armazena em cache várias alterações 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 ao método Update. As operações posteriores 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 EditMode ainda será adEditAdd. A propriedade EditMode só é redefinida para adEditNone após a chamada a UpdateBatch. Para determinar as operações que foram executadas, defina a propriedade Filter como adFilterPending para que apenas os registros com alterações pendentes fiquem visíveis e examine a propriedade Status de cada registro para determinar as alterações que foram feitas nos dados.

Observação

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

Aplica-se A

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)
Método Delete (Conjunto de registros ADO)
Método CancelUpdate (ADO)
Método Update