PreparingEnlistment Класс

Определение

Пространство имен:

System.Transactions

Сборки:

netstandard.dll, System.Transactions.Local.dll

Исходный код:

PreparingEnlistment.cs

Упрощает взаимодействие между участником заверяемой транзакции и диспетчером транзакций во время этапа подготовки транзакции.

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

public class PreparingEnlistment : System.Transactions.Enlistment

type PreparingEnlistment = class
    inherit Enlistment

Public Class PreparingEnlistment
Inherits Enlistment

Наследование

Object

Enlistment

PreparingEnlistment

Примеры

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

Комментарии

Во время начального (подготовки) этапа транзакции диспетчер транзакций передает этот тип диспетчеру ресурсов путем вызова Prepare метода для получения голосования ресурса по транзакции. В зависимости от того, голосует ли он за фиксацию или откат, реализация диспетчера ресурсов должна вызывать Prepared методы или ForceRollback методы этого типа.

Диспетчер ресурсов также может вызывать Done метод в любое время, прежде чем он вызвал Prepared метод. Таким образом, зачисление приводит только к чтению голосов, что означает, что он голосует за транзакцию, но не требует получения окончательного результата.

Устойчивые диспетчеры ресурсов могут получить сведения, необходимые диспетчеру транзакций для повторного RecoveryInformation() зачисления из свойства. Дополнительные сведения о восстановлении см. в разделе "Выполнение восстановления".

Методы

Имя	Описание
Done()	Указывает, что участник транзакции завершил свою работу. (Унаследовано от Enlistment)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ForceRollback()	Указывает, что транзакция должна быть откатена.
ForceRollback(Exception)	Указывает, что транзакция должна быть откатена.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Prepared()	Указывает, что транзакция может быть зафиксирована.
RecoveryInformation()	Возвращает сведения о восстановлении перечисления.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Потокобезопасность

Этот тип является потокобезопасной.

См. также раздел

• Фиксация транзакции в Single-Phase и многоэтапном режиме