Enlistment Třída

Definice

Obor názvů:

System.Transactions

Sestavení:

netstandard.dll, System.Transactions.Local.dll

Zdroj:

Enlistment.cs

Usnadňuje komunikaci mezi zařazeným účastníkem transakce a správcem transakcí během konečné fáze transakce.

public ref class Enlistment

public class Enlistment

type Enlistment = class

Public Class Enlistment

Dědičnost

Object

Enlistment

Odvozené

System.Transactions.PreparingEnlistment

System.Transactions.SinglePhaseEnlistment

Příklady

Následující příklad ukazuje implementaci IEnlistmentNotification rozhraní a kdy Done by měla být volána metoda.

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

Poznámky

EnlistVolatile Když jsou vyvolány a EnlistDurable metody objektu Transaction za účelem zařazení účastníka do transakce, vrátí tento objekt popisující zařazení.

Během poslední fáze potvrzení transakce správce transakcí předá tento objekt správci prostředků implementuje IEnlistmentNotification rozhraní, které je zařazeno do transakce. Konkrétně správce transakcí volá buď metodu Commit nebo Rollback metodu účastníka v závislosti na tom, zda se druhý rozhodl potvrdit nebo vrátit transakce zpět. Účastník by měl zavolat metodu Done tohoto objektu dát správci transakcí vědět, že dokončil svou práci.

Zařazení může metodu Done volat kdykoli předtím, než volá Prepared ve fázi přípravy. Tímto způsobem zařazení přetypuje hlasování jen pro čtení, což znamená, že hlasuje potvrzení o transakci, ale nemusí přijímat konečný výsledek. Všimněte si, že po Done zavolání metody obdrží účastník zařazení žádné další oznámení od správce transakcí.

Metody

Name	Description
Done()	Označuje, že účastník transakce dokončil svou práci.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.

Viz také

• PreparingEnlistment
• IEnlistmentNotification
• Zařazení prostředků jako účastníků transakce