Propriedade AbsolutePosition (ADO)
Indica a posição ordinal de um conjunto de registros registro atual do objeto.
Configurações e valores retornados
Para 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 código de 64 bits, use um tipo de dados que forneça um 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.
Observações
Para definir a propriedade AbsolutePosition, o ADO requer que o provedor OLE DB que você está usando implemente a interface IRowsetLocate:IRowset.
Acessar a propriedade AbsolutePosition de um Recordset aberto com um cursor dinâmico ou somente encaminhamento gera o erro adErrFeatureNotAvailable. Com outros tipos de cursor, 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 de IRowsetScroll, a propriedade será definida como adPosUnknown. Consulte a documentação do provedor para determinar se ele dá suporte a IRowsetScroll.
Use a propriedade AbsolutePosition para mover para um registro com base em sua posição ordinal no objeto Recordset ou para determinar a posição ordinal do registro atual. O provedor deve dar suporte à funcionalidade apropriada para que essa propriedade esteja disponível.
Assim como a propriedade AbsolutePage, AbsolutePosition é baseado 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.
Nota
Você não deve usar a propriedade AbsolutePosition como um número de registro alternativo. A posição de um determinado registro muda quando você exclui um registro anterior. Também não há garantia de que um determinado registro terá o mesmo AbsolutePosition se o objeto Recordset for requerido ou reaberto. Os indicadores ainda são a maneira recomendada de reter e retornar a uma determinada posição e são a única maneira de posicionar em todos os tipos de objetos recordset.
Aplica-se a
do objeto Recordset (ADO)
Consulte Também
Exemplo das propriedades AbsolutePosition e CursorLocation (VB)
Exemplo das propriedades AbsolutePosition e CursorLocation (VC++)
propriedade AbsolutePage (ADO)
propriedade RecordCount (ADO)