conjunto de registros: Rolagem (ODBC)

Artigo
08/25/2010

Este tópico se aplica a classes MFC ODBC.

Depois de em em aberto um conjunto de registros, você precisa para acessar os registros para exibir valores, fazer cálculos, gerar relatórios e assim por diante.Permite que você se move de registro para registro em seu conjunto de registros de rolagem.

Este tópico explica:

Como rolar de um registro para outro em um conjunto de registros.
Sob quais circunstâncias de rolagem é e não suportado.

Rolagem de um registro para outro

De classeCRecordset Fornece o Mover funções de membro para a rolagem em um conjunto de registros.Mover essas funções a registro corrente por conjuntos de linhas.Se tiver implementado em massa linha buscar, um Mover operação reposiciona o conjunto de registros pelo dimensionar do conjunto de linhas.Se não tiver implementado em massa linha buscar, uma telefonar para um Mover função reposiciona o conjunto de registros por um registro de cada vez.Para obter mais informações sobre buscar a linha em massa, consulte conjunto de registros: Buscando os registros em massa (ODBC).

Observação:
Quando estiver movendo por meio de um conjunto de registros, registros excluídos não podem ser ignorados.Para obter mais informações, consulte o Éexcluídofunção de membro .

Juntamente com o Mover funçõesCRecordset fornece funções de membro para verificar se você percorreu ultrapassarem participante ou antes do início do seu conjunto de registros.

Para determinar se é possível no conjunto de registros, rolagem telefonar o CanScroll função de membro.

Para rolar

Encaminhar um registro ou um conjunto de linhas: telefonar the MoveNextfunção de membro .
Com versões anteriores de um registro ou um conjunto de linhas: telefonar the MovePrevfunção de membro .
Para o primeiro registro no conjunto de registros: telefonar the MoveFirstfunção de membro .
Para o último registro no conjunto de registros ou para o último conjunto de linhas: telefonar the MoveLastfunção de membro .
N registros em relação à posição corrente: telefonar the Moverfunção de membro .

Para testar o participante ou início do conjunto de registros

Você percorreu após o último registro?telefonar the IsEOFfunção de membro .
Você percorreu antes do primeiro registro (mover para trás)?Chamar o IsBOFfunção de membro .

O exemplo de código a seguir usa IsBOF e IsEOF para detectar os limites de um conjunto de registros durante a rolagem em qualquer direção.

// Open a recordset; first record is current
CCustSet rsCustSet( NULL );
rsCustSet.Open( );

if( rsCustSet.IsBOF( ) )
    return;
    // The recordset is empty

// Scroll to the end of the recordset, past
// the last record, so no record is current
while ( !rsCustSet.IsEOF( ) )
    rsCustSet.MoveNext( );

// Move to the last record
rsCustSet.MoveLast( );

// Scroll to beginning of the recordset, before
// the first record, so no record is current
while( !rsCustSet.IsBOF( ) )
    rsCustSet.MovePrev( );

// First record is current again
rsCustSet.MoveFirst( );

IsEOF Retorna um valor diferente de zero se o conjunto de registros é posicionado após o último registro. IsBOF Retorna um valor diferente de zero se o conjunto de registros é posicionado antes do primeiro registro (antes de todos os registros). Em ambos os casos, não há nenhum registro corrente para operar em.Se você chamar MovePrev Quando IsBOF já está TRUE or telefonar MoveNext Quando IsEOF já está TRUE, a estrutura lança um CDBException. Você também pode usar IsBOF e IsEOF Para verificar se há um conjunto de registros vazio.

Para obter mais informações sobre navegação do conjunto de registros, consulte Recordset: Indicadores e absoluto Positions (ODBC).

Quando a rolagem é suportada

Conforme originalmente projetada, SQL fornecido somente encaminhar de rolagem, mas ODBC amplia sistema autônomo recursos de rolagem.O nível de suporte para rolagem disponível depende do seu aplicativo funciona com ODBC API nível de conformidade do seu driver, os drivers de ODBC e se a biblioteca de cursores ODBC é carregada na memória.Para obter mais informações, consulte ODBC and ODBC: A ODBC biblioteca de cursores.

Dica:
Você pode controlar se a biblioteca de cursores é usada.Consulte o bUseCursorLib e dwOptions parâmetros para CDatabase::em aberto.

Observação:
Diferentemente das classes MFC DAO, as classes MFC ODBC não fornecem um conjunto de Localizar funções para localizar o registro seguinte (ou anterior) que atende aos critérios especificados.