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++)