Transação: Executando uma transação em um conjunto de registros (ODBC)

Este tópico explica como executar uma transação em um conjunto de registros.

Observação
Apenas um nível de transações é suportado; não é possível aninhar transações.

Para realizar uma transação em um conjunto de registros.

1. Chamar o CDatabase do objeto BeginTrans a função de membro.

2. Se você não implementou a busca de linha em massa, chame o AddNew/atualizar, Editar/atualizar, e Excluir funções de membro de um ou mais objetos recordset do mesmo banco de dados quantas vezes forem necessárias. Para obter mais informações, consulte Recordset: Adicionar, atualizar e excluir registros (ODBC). Se você implementou a linha de massa buscando, você deve escrever suas próprias funções para atualizar a fonte de dados.

3. Finalmente, chame o CDatabase do objeto CommitTrans a função de membro. Se ocorrer um erro em uma das atualizações ou decidir cancelar as alterações, ligue para seu reversão a função de membro.

O exemplo a seguir usa dois conjuntos de registros para excluir o registro de um aluno de um banco de dados de registro de escola, o aluno a remoção de todas as classes em que o aluno está inscrito. Porque o Excluir chamadas em ambos os conjuntos de registros devem ter êxito, uma transação é necessária. O exemplo pressupõe a existência de m_dbStudentReg, uma variável de membro do tipo CDatabase já conectado à fonte de dados e as classes de conjunto de registros CEnrollmentSet e CStudentSet. O strStudentID variável contém um valor obtido do usuário.

BOOL CEnrollDoc::RemoveStudent( CString strStudentID )
{
    // remove student from all the classes
    // the student is enrolled in

    if ( !m_dbStudentReg.BeginTrans( ) )
        return FALSE;

    CEnrollmentSet rsEnrollmentSet(&m_dbStudentReg);
    rsEnrollmentSet.m_strFilter = "StudentID = " + strStudentID;

    if ( !rsEnrollmentSet.Open(CRecordset::dynaset) )
        return FALSE;

    CStudentSet rsStudentSet(&m_dbStudentReg);
    rsStudentSet.m_strFilter = "StudentID = " + strStudentID;

    if ( !rsStudentSet.Open(CRecordset::dynaset) )
        return FALSE;

    TRY
    {
        while ( !rsEnrollmentSet.IsEOF( ) )
        {
            rsEnrollmentSet.Delete( );
            rsEnrollmentSet.MoveNext( );
        }

        // delete the student record
        rsStudentSet.Delete( );

        m_dbStudentReg.CommitTrans( );
    }

    CATCH_ALL(e)
    {
        m_dbStudentReg.Rollback( );
        return FALSE;
    }
    END_CATCH_ALL

    rsEnrollmentSet.Close( );
    rsStudentSet.Close( );

    return TRUE;

}

Observação
Chamando BeginTrans novamente sem chamada CommitTrans ou reversão é um erro.

Consulte também

Referência

CDatabase Class

CRecordset Class

Conceitos

Transação (ODBC)

Transação: Como transações afetam atualizações (ODBC)