Propriedade AbsolutePosition (ADO)

Aplica-se ao: Access 2013, Office 2013

Indica a posição ordinal do registro atual de um objeto Recordset.

Configurações e valores retornados

Define ou retorna um valor Long de 1 até o número de registros no objeto Recordset (RecordCount) ou retorna um dos valores PositionEnum.

Comentários

Para definir a propriedade AbsolutePosition , o ADO exige que o provedor OLE DB que você está usando implemente a interface IRowsetLocate.

O acesso à propriedade AbsolutePosition de um Recordset aberto usando um cursor somente de encaminhamento ou dinâmico provoca o erro adErrFeatureNotAvailable. Com outros tipos de cursor, a posição correta será retornada, desde que o provedor ofereça suporte à interface IRowsetScroll. Se o provedor não oferecer suporte a essa interface, a propriedade será definida como adPosUnknown. Consulte a documentação do seu provedor para identificar se ele oferece suporte à IRowsetScroll.

Use a propriedade AbsolutePosition para mover um registro, de acordo com sua posição ordinal no objeto Recordset ou para determinar a posição ordinal do registro atual. O provedor deve oferecer suporte à funcionalidade apropriada para que essa propriedade esteja disponível.

Assim como a propriedade AbsolutePage, AbsolutePosition tem base unitária e equivale a 1 quando o registro atual é o primeiro registro no Recordset. É possível obter o número total de registros no objeto Recordset usando a propriedade RecordCount.

Quando você define a propriedade AbsolutePosition , mesmo que seja para um registro no cache atual, o ADO recarrega o cache com um novo grupo de registros começando com o registro especificado. A propriedade CacheSize determina o tamanho desse grupo.

Observação

[!OBSERVAçãO] A propriedade AbsolutePosition não deve ser usada como um número de registro substituto. A posição de um determinado registro é alterada quando um registro precedente é excluído. Também não há garantias de que um determinado registro terá a mesma AbsolutePosition se o objeto Recordset for consultado e aberto novamente. Os indicadores ainda são a maneira recomendada de manter e retornar a uma determinada posição e são a única maneira de posicionar em todos os tipos de objetos Recordset .