IDbTransaction Interfejs

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Reprezentuje transakcję do wykonania w źródle danych i jest implementowana przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.

public interface class IDbTransaction : IDisposable

public interface IDbTransaction : IDisposable

type IDbTransaction = interface
    interface IDisposable

Public Interface IDbTransaction
Implements IDisposable

Pochodne

System.Data.Common.DbTransaction

Implementuje

IDisposable

Przykłady

Poniższy przykład tworzy wystąpienia klas SqlConnection pochodnych i SqlTransaction. Demonstruje również sposób używania BeginTransactionmetod , Commiti Rollback .

private static void ExecuteSqlTransaction(string connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();

        SqlCommand command = connection.CreateCommand();
        SqlTransaction transaction;

        // Start a local transaction.
        transaction = connection.BeginTransaction();

        // Must assign both transaction object and connection
        // to Command object for a pending local transaction
        command.Connection = connection;
        command.Transaction = transaction;

        try
        {
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
            command.ExecuteNonQuery();
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
            command.ExecuteNonQuery();

            // Attempt to commit the transaction.
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception ex)
        {
            Console.WriteLine("Commit Exception Type: {0}", ex.GetType());
            Console.WriteLine("  Message: {0}", ex.Message);

            // Attempt to roll back the transaction.
            try
            {
                transaction.Rollback();
            }
            catch (Exception ex2)
            {
                // This catch block will handle any errors that may have occurred
                // on the server that would cause the rollback to fail, such as
                // a closed connection.
                Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType());
                Console.WriteLine("  Message: {0}", ex2.Message);
            }
        }
    }
}

Private Sub ExecuteSqlTransaction(ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Dim command As SqlCommand = connection.CreateCommand()
        Dim transaction As SqlTransaction

        ' Start a local transaction
        transaction = connection.BeginTransaction()

        ' Must assign both transaction object and connection
        ' to Command object for a pending local transaction.
        command.Connection = connection
        command.Transaction = transaction

        Try
            command.CommandText = _
              "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
            command.ExecuteNonQuery()
            command.CommandText = _
              "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"

            command.ExecuteNonQuery()

            ' Attempt to commit the transaction.
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")

        Catch ex As Exception
            Console.WriteLine("Commit Exception Type: {0}", ex.GetType())
            Console.WriteLine("  Message: {0}", ex.Message)

            ' Attempt to roll back the transaction.
            Try
                transaction.Rollback()

            Catch ex2 As Exception
                ' This catch block will handle any errors that may have occurred
                ' on the server that would cause the rollback to fail, such as
                ' a closed connection.
                Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType())
                Console.WriteLine("  Message: {0}", ex2.Message)
            End Try
        End Try
    End Using
End Sub

Uwagi

Interfejs IDbTransaction umożliwia dziedziczonej klasie zaimplementowanie klasy Transaction, która reprezentuje transakcję do wykonania w źródle danych. Aby uzyskać więcej informacji na temat klas transakcji, zobacz Transakcje i współbieżność.

Aplikacja nie tworzy bezpośrednio wystąpienia interfejsu IDbTransaction , ale tworzy wystąpienie klasy dziedziczonej IDbTransaction.

Klasy dziedziczone IDbTransaction muszą implementować dziedziczone elementy członkowskie i zwykle definiują dodatkowe elementy członkowskie w celu dodania funkcji specyficznych dla dostawcy. Na przykład IDbTransaction interfejs definiuje metodę Commit . Z kolei OleDbTransaction klasa dziedziczy tę właściwość, a także definiuje metodę Begin .

Uwagi dotyczące implementowania

Aby podwyższyć spójność między dostawcami danych .NET Framework, nazwij klasę dziedziczą w postaci Prv Transaction, gdzie Prv jest jednolity prefiks nadany wszystkim klasom w określonej przestrzeni nazw dostawcy danych .NET Framework. Na przykład Sql jest prefiksem SqlTransaction klasy w System.Data.SqlClient przestrzeni nazw.

Właściwości

Connection	Określa obiekt Połączenia do skojarzenia z transakcją.
IsolationLevel	Określa IsolationLevel dla tej transakcji.

Metody

Commit()	Zatwierdza transakcję bazy danych.
Dispose()	Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych. (Odziedziczone po IDisposable)
Rollback()	Cofa transakcję ze stanu oczekiwania.