PreparingEnlistment Klasse

Definition

Namespace:

System.Transactions

Assembly:

System.Transactions.Local.dll

Assembly:

System.Transactions.dll

Assembly:

netstandard.dll

Erleichtert die Kommunikation zwischen einem eingetragenen Transaktionsteilnehmer und dem Transaktions-Manager in der Vorbereitungsphase der Transaktion.

public ref class PreparingEnlistment : System::Transactions::Enlistment

public class PreparingEnlistment : System.Transactions.Enlistment

type PreparingEnlistment = class
    inherit Enlistment

Public Class PreparingEnlistment
Inherits Enlistment

Vererbung

Object

Enlistment

PreparingEnlistment

Beispiele

class myEnlistmentClass : IEnlistmentNotification
{
    public void Prepare(PreparingEnlistment preparingEnlistment)
    {
        Console.WriteLine("Prepare notification received");

        //Perform transactional work

        //If work finished correctly, reply prepared
        preparingEnlistment.Prepared();

        // otherwise, do a ForceRollback
        preparingEnlistment.ForceRollback();
    }

    public void Commit(Enlistment enlistment)
    {
        Console.WriteLine("Commit notification received");

        //Do any work necessary when commit notification is received

        //Declare done on the enlistment
        enlistment.Done();
    }

    public void Rollback(Enlistment enlistment)
    {
        Console.WriteLine("Rollback notification received");

        //Do any work necessary when rollback notification is received

        //Declare done on the enlistment
        enlistment.Done();
    }

    public void InDoubt(Enlistment enlistment)
    {
        Console.WriteLine("In doubt notification received");

        //Do any work necessary when indout notification is received
        
        //Declare done on the enlistment
        enlistment.Done();
    }
}

Public Class EnlistmentClass
    Implements IEnlistmentNotification

    Public Sub Prepare(ByVal myPreparingEnlistment As PreparingEnlistment) Implements System.Transactions.IEnlistmentNotification.Prepare
        Console.WriteLine("Prepare notification received")

        'Perform transactional work

        'If work finished correctly, reply with prepared
        myPreparingEnlistment.Prepared()
    End Sub

    Public Sub Commit(ByVal myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.Commit
        Console.WriteLine("Commit notification received")

        'Do any work necessary when commit notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub

    Public Sub Rollback(ByVal myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.Rollback
        Console.WriteLine("Rollback notification received")

        'Do any work necessary when rollback notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub

    Public Sub InDoubt(ByVal myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.InDoubt
        Console.WriteLine("In doubt notification received")

        'Do any work necessary when indout notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub
End Class

Hinweise

Während der anfänglichen (Vorbereitung) Phase der Transaktion übergibt der Transaktionsmanager diesen Typ an den Ressourcenmanager, indem die Methode aufgerufen wird, um die Abstimmung einer Ressource für die Prepare Transaktion abzurufen. Je nachdem, ob sie zum Commit oder Rollback stimmt, sollte Die Implementierung des Ressourcen-Managers die oder ForceRollback die Prepared Methoden dieses Typs aufrufen.

Der Ressourcen-Manager kann die Methode jederzeit aufrufen, bevor er die Done Prepared Methode aufgerufen hat. Dadurch wird die Einlistung eine schreibgeschützte Abstimmung abgegeben, d. h., dass sie sich für die Transaktion einsetzt, aber nicht das endgültige Ergebnis erhalten muss.

Dauerhafte Ressourcenmanager können die Informationen abrufen, die vom Transaktions-Manager für die Wiedereinlistung aus der RecoveryInformation Eigenschaft benötigt werden. Weitere Informationen zur Wiederherstellung finden Sie unter "Ausführen der Wiederherstellung".

Methoden

Done()	Gibt an, dass der Transaktionsteilnehmer seine Aufgaben abgeschlossen hat. (Geerbt von Enlistment)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ForceRollback()	Gibt an, dass ein Rollback für die Transaktion ausgeführt werden soll.
ForceRollback(Exception)	Gibt an, dass ein Rollback für die Transaktion ausgeführt werden soll.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Prepared()	Gibt an, dass ein Commit für die Transaktion ausgeführt werden kann.
RecoveryInformation()	Ruft die Wiederherstellungsinformationen einer Eintragung ab.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Threadsicherheit

Dieser Typ ist threadsicher.

Siehe auch

• Festlegen einer Transaktion in Single-Phase und Mehrphasen