Propriedades BOF, EOF (ADO)

Aplica-se ao: Access 2013, Office 2013

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

EOF — Indica que a posição do registro atual é após o último registro em um objeto Recordset.

Valor de retorno

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ê foi além dos limites de um objeto Recordset ao passar de um registro para outro.

A propriedade BOF retorna Verdadeiro (-1) se a posição do registro atual for antes do primeiro registro e Falso (0) se a posição for no primeiro registro ou após ele.

A propriedade EOF retorna Verdadeiro se a posição do registro atual for após o último registro e Falso se a posição do registro atual for no último registro ou antes dele.

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

Se você abrir um objeto Recordset sem nenhum registro, as propriedades BOF e EOF são configuradas como Verdadeiro (consulte a propriedade RecordCount para obter mais informações sobre esse estado de um Recordset). Quando você abre um objeto Recordset contendo ao menos um registro, o primeiro registro será o registro atual e as propriedades BOF e EOF são Falsas.

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

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

A permissão para um método Move não garante que o método localizará com sucesso um registro; ela apenas significa que a chamada para o método Move especificado não resultará em erro.

A tabela a seguir mostra o que acontece às configurações de propriedade de BOF e EOF quando você chama diversos métodos Move mas não consegue localizar com sucesso um registro.