BOF, EOF (propiedades) (ADO)
BOF indica que la posición del registro actual es anterior al primer registro de un objeto Recordset.
EOF indica que la posición del registro actual es posterior al último registro de un objeto Recordset.
Valor devuelto
Las propiedades BOF y EOF devuelven valores booleanos.
Comentarios
Use las propiedades BOF y EOF para determinar si un objeto Recordset contiene registros o si ha superado los límites de un objeto Recordset al pasar de un registro a otro.
La propiedad BOF devuelve True (-1) si la posición del registro actual es anterior al primer registro y False (0) si la posición del registro actual está en o después del primer registro.
La propiedad EOF devuelve True si la posición del registro actual es posterior al último registro y False si la posición del registro actual está en o antes del último registro.
Si la propiedad BOF o EOF es True, no hay ningún registro actual.
Si abre un objeto Recordset que no contiene registros, las propiedades BOF y EOF se establecen en True (vea la propiedad RecordCount para obtener más información sobre este estado de un objeto Recordset). Cuando se abre un objeto Recordset que contiene al menos un registro, el primer registro es el registro actual y las propiedades BOF y EOF son False.
Si elimina el último registro restante en el objeto Recordset, las propiedades BOF y EOF pueden mantenerse como False hasta que intente cambiar la posición del registro actual.
En esta tabla se muestra qué métodos Move se admiten con diferentes combinaciones de las propiedades BOF y EOF.
| MoveFirst, MoveLast |
MovePrevious, Move < 0 |
Move 0 | MoveNext, Move > 0 |
|
|---|---|---|---|---|
| BOF=True, EOF=False | Permitida | Error | Error | Permitida |
| BOF=False, EOF=True | Permitida | Permitida | Error | Error |
| Ambos True | Error | Error | Error | Error |
| Ambos False | Permitida | Permitida | Permitida | Permitida |
Permitir un método Move no garantiza que el método busque correctamente un registro; solo significa que llamar al método Move especificado no generará un error.
En la tabla siguiente se muestra lo que sucede con la configuración de las propiedades BOF y EOF cuando se llama a varios métodos Move, pero no se puede encontrar correctamente un registro.
| BOF | EOF | |
|---|---|---|
| MoveFirst, MoveLast | Establecer en True | Establecer en True |
| Move 0 | Sin cambios | Sin cambios |
| MovePrevious, Move< 0 | Establecer en True | Sin cambios |
| MoveNext, Move> 0 | Sin cambios | Establecer en True |
Se aplica a
Objeto de conjunto de registros (ADO)
Consulte también
Ejemplo de las propiedades BOF, EOF y Bookmark (VB)
Ejemplo de las propiedades BOF, EOF y Bookmark (VC++)