Compartilhar via


CRecordset::SetAbsolutePosition

Posiciona o conjunto de registros no registro que corresponde ao número de registro especificado.

void SetAbsolutePosition( 
   long nRows  
);

Parâmetros

  • nRows
    A posição ordinal baseado em um para o registro atual no conjunto de registros.

Comentários

SetAbsolutePosition move o ponteiro de registro atual com base em essa posição ordinal.

Dica

Essa função de membro é válido em conjuntos de registros somente encaminhamentos.

Para conjuntos de registros ODBC, a configuração da posição absoluta de 1 se refere ao primeiro registro no conjunto de registros; uma configuração de 0 se refere a posição de início -- Arquivo (BOF).

Você também pode passar valores negativos a SetAbsolutePosition. A posição do conjunto de registros é avaliada em esse caso o final do conjunto de registros. Por exemplo, SetAbsolutePosition( -1 ) move o ponteiro de registro atual o último registro no conjunto de registros.

Dica

A posição absoluta não se destina a ser usado como um número de registro substituta.Indexadores ainda são a maneira recomendada para manter e retornar a uma posição determinada, desde que a posição de um registro foi alterado quando registros são excluídos de precedência.Além de isso, você não pode assegurar-se que um determinado registro terá a mesma posição absoluta se o conjunto de registros é re-criada novamente porque a ordem de registros individuais em um conjunto de registros não é garantida a menos que seja criado com uma instrução SQL usando uma cláusula de ORDENAR POR .

Para obter mais informações sobre navegação e de indexadores do conjunto de registros, consulte os artigos conjunto de registros: Rolagem (ODBC) e conjunto de registros: Indexadores e posições absolutas (ODBC).

Exceções

Esse método pode lançar exceções do tipo CDBException* e CMemoryException*.

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe CRecordset

Gráfico da hierarquia

CRecordset::SetBookmark