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
Consulte Também
Exemplo das propriedades BOF, EOF e Bookmark (VB)
Exemplo das propriedades BOF, EOF e Bookmark (VC++)