Compartilhar via


Propriedades BOF, EOF (ADO)

  • BOF Indica que a posição atual do registro é antes do primeiro registro em um objeto Recordset.

  • EOF Indica que a posição do registro atual é depois do último registro em um objeto Recordset.

Valor Retornado

As propriedades BOF e EOF retornam valores booleanos.

Comentários

Use as propriedades BOF e EOF para determinar se um objeto Recordset contém registros ou se você ultrapassou os limites de um objeto Recordset ao mover de registro para registro.

A propriedade BOF retornará True (-1) se a posição atual do registro estiver antes do primeiro registro e False (0) se a posição atual do registro estiver ativada ou após o primeiro registro.

A propriedade EOF retornará True se a posição atual do registro estiver depois do último registro e False se a posição atual do registro estiver ativada ou antes do último registro.

Se a propriedade BOF ou EOF for True, não haverá registro atual.

Se você abrir um objeto Recordset sem registros, as propriedades BOF e EOF serão definidas como True (consulte a propriedade RecordCount para obter mais informações sobre esse estado de um Recordset). Quando você abre um objeto Recordset que contém pelo menos um registro, o primeiro registro é o registro atual e as propriedades BOF e EOF são False.

Se você excluir o último registro restante no objeto Recordset, as propriedades BOF e EOF poderão permanecer como False até você tentar reposicionar o registro atual.

Esta tabela mostra os métodos Move que são permitidos com combinações diferentes das propriedades BOF e EOF.

MoveFirst,

MoveLast
MovePrevious,

Move < 0
Move 0 MoveNext,

Move > 0
BOF=True, EOF=False Permitido Erro Erro Permitido
BOF=False, EOF=True Permitido Permitido Erro Erro
Ambos True Erro Erro Erro Erro
Ambos False Permitido Permitido Permitido Permitido

Permitir um método Move não garante que o método localize com êxito um registro; isso significa apenas que chamar o método Move especificado não vai gerar um erro.

A tabela a seguir mostra o que acontece com as configurações das propriedades BOF e EOF quando você chama vários métodos Move, mas não consegue localizar um registro com êxito.

BOF EOF
MoveFirst, MoveLast Definir como True Definir como True
Move 0 Nenhuma alteração Nenhuma alteração
MovePrevious, Move< 0 Definir como True Nenhuma alteração
MoveNext, Move> 0 Nenhuma alteração Definir como True

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo das propriedades BOF, EOF e Bookmark (VB)
Exemplo das propriedades BOF, EOF e Bookmark (VC++)