PreparingEnlistment Classe

Définition

Espace de noms:

System.Transactions

Assembly:

System.Transactions.Local.dll

Assembly:

System.Transactions.dll

Assembly:

netstandard.dll

Facilite la communication entre un participant de transaction inscrit et le gestionnaire de transactions pendant la phase de préparation de la transaction.

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

public class PreparingEnlistment : System.Transactions.Enlistment

type PreparingEnlistment = class
    inherit Enlistment

Public Class PreparingEnlistment
Inherits Enlistment

Héritage

Object

Enlistment

PreparingEnlistment

Exemples

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

Remarques

Au cours de la phase initiale (préparation) de la transaction, le gestionnaire de transactions transmet ce type au gestionnaire de ressources en appelant la méthode pour obtenir le Prepare vote d’une ressource sur la transaction. Selon qu’il vote pour valider ou restaurer, votre implémentation du gestionnaire de ressources doit appeler les méthodes ou ForceRollback les Prepared méthodes de ce type.

Le gestionnaire de ressources peut également appeler la Done méthode à tout moment avant d’avoir appelé la Prepared méthode. Dans ce cas, l’inscription porte un vote en lecture seule, ce qui signifie qu’elle vote sur la transaction, mais n’a pas besoin de recevoir le résultat final.

Les gestionnaires de ressources durables peuvent récupérer les informations nécessaires par le gestionnaire de transactions pour réinscrire à partir de la RecoveryInformation propriété. Pour plus d’informations sur la récupération, consultez Exécution de la récupération.

Méthodes

Done()	Indique que le participant à la transaction a terminé son travail. (Hérité de Enlistment)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ForceRollback()	Indique que la transaction doit être restaurée.
ForceRollback(Exception)	Indique que la transaction doit être restaurée.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Prepared()	Indique que la transaction peut être validée.
RecoveryInformation()	Obtient les informations de récupération d'une inscription.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Cohérence de thread

Ce type est thread-safe.

Voir aussi

• Validation d’une transaction en Single-Phase et en plusieurs phases