Propriedade AbsolutePosition (ADO)

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

Configurações e valores retornados

Para o código de 32 bits, define ou retorna um valor Long de 1 para o número de registros no objeto Recordset (RecordCount) ou retorna um dos valores PositionEnum.

Para o código de 64 bits, use um tipo de dados que forneça o armazenamento de um valor de 64 bits. Por exemplo, você pode usar Long ou outro valor de 64 bits, como DBORDINAL. Não use valores PositionEnum, pois eles são limitados a 32 bits de comprimento.

Comentários

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

O acesso da propriedade AbsolutePosition de um Recordset aberto com um cursor dinâmico ou de somente avanço gera o erro adErrFeatureNotAvailable. Com outros tipos de cursores, a posição correta será retornada desde que o provedor OLE DB dê suporte à interface IRowsetScroll:IRowsetLocate. Se o provedor não der suporte à interface IRowsetScroll, a propriedade será definida como adPosUnknown. Confira a documentação do provedor para determinar se ele dá suporte a IRowsetScroll.

Use a propriedade AbsolutePosition para ir para um registro com base na posição ordinal no objeto Recordset ou para determinar a posição ordinal do registro atual. O provedor precisa dar suporte à funcionalidade apropriada para que essa propriedade esteja disponível.

Assim como a propriedade AbsolutePage, AbsolutePosition é baseada em 1 e é igual a 1 quando o registro atual é o primeiro registro no Recordset. Você pode obter o número total de registros no objeto Recordset da 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

Você não deve usar a propriedade AbsolutePosition como um número de registro alternativo. A posição de determinado registro é alterada quando você exclui um registro anterior. Também não há garantia de que determinado registro terá a mesma AbsolutePosition se o objeto Recordset for consultado novamente ou reaberto. Os indicadores ainda são a maneira recomendada de reter e retornar a uma posição especificada e são a única forma de posicionamento em todos os tipos de objetos Recordset.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo de AbsolutePosition e CursorLocation (VB)
Exemplo de AbsolutePosition e CursorLocation (VC++)
Propriedade AbsolutePage (ADO)
Propriedade RecordCount (ADO)