Transação: Executar 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
Há suporte para apenas um nível de transações; não é possível aninhar transações.

Para executar uma transação em um conjunto de registros

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

2. Se não tiver implementado em massa linha buscando, chamar o AddNew/Update, 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: adicionando, atualizando e excluindo registros (ODBC).Se você implementou linha em massa buscando, você deve escrever suas próprias funções para atualizar a fonte de dados.

3. Finalmente, chamar o CDatabase do objeto CommitTrans função de membro.Se ocorrer um erro em uma das atualizações ou decidir cancelar as alterações, chamar o reversão 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 escolar, removendo o aluno 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 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

Classe incorporadas

Classe CRecordset

Conceitos

Transação (ODBC)

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