Limites de um conjunto de registros
Aplica-se ao: Access 2013, Office 2013
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 se mover de um registro para outro. Pense nas propriedades BOF e EOF como registros "fantasmas" que são posicionados no início e no final de cada Recordset. Desenvolver o Recordset a partir de Examinando dados daria a seguinte aparência ao objeto:
Productid |
ProductName |
Preçounitário |
---|---|---|
BOF |
|
|
7 |
Pêras secas orgânicas do Tio Bob |
30.0000 |
14 |
Tofu |
23.2500 |
28 |
Chucrute Rssle |
45.6000 |
51 |
Maçãs secas Manjimup |
53.0000 |
74 |
Tofu longa vida |
10.0000 |
EOF |
|
|
A propriedade BOF retornará True (-1) se a posição do registro atual estiver antes do primeiro registro e False (0) se a posição do registro atual estiver no ou depois do primeiro registro.
A propriedade EOF retornará True se a posição do registro atual estiver depois do último registro e Falso se a posição atual do registro estiver no ou antes do último registro.
Se a propriedade BOF ou EOF for True, não haverá registro atual, conforme mostrado no código a seguir:
If oRs.BOF And oRs.EOF Then
' Command returned no records.
End If
Se você abrir um objeto Recordset que não contenha registros, as propriedades BOF e EOF serão definidas como True e o valor da configuração da propriedade RecordCount do objeto Recordset dependerá do tipo de cursor. -1 será retornado para cursores dinâmicos (CursorType = adOpenDynamic) e 0 será retornado para outros cursores.
Ao abrir um objeto Recordset que contenha pelo menos um registro, o primeiro registro será o registro atual e as propriedades BOF e EOF serão False.
Se você excluir o último registro do objeto Recordset, o cursor será deixado em estado indeterminado. As propriedades BOF e EOF podem permanecer como False até que seja feita uma tentativa de reposicionamento do registro atual, de acordo com o provedor.