IEnlistmentNotification Arabirim

Tanım

Ad Alanı:

System.Transactions

Bütünleştirilmiş Kod:

System.Transactions.Local.dll

Katılım için kaydolan işlem yöneticisi için iki aşamalı işleme bildirimi geri çağırmaları sağlamak üzere bir kaynak yöneticisinin uygulaması gereken arabirimi açıklar.

public interface class IEnlistmentNotification

public interface IEnlistmentNotification

type IEnlistmentNotification = interface

Public Interface IEnlistmentNotification

Türetilmiş

System.Transactions.ISinglePhaseNotification

Örnekler

Aşağıdaki örnekte bu arabirimin bir uygulaması ve yöntemini kullanarak nesnesini bir işlem katılımcısı olarak listeleme gösterilmektedir EnlistVolatile .

static void Main(string[] args)
{
    try
    {
        using (TransactionScope scope = new TransactionScope())
        {
        
            //Create an enlistment object
            myEnlistmentClass myElistment = new myEnlistmentClass();

            //Enlist on the current transaction with the enlistment object
            Transaction.Current.EnlistVolatile(myElistment, EnlistmentOptions.None);

            //Perform transactional work here.

            //Call complete on the TransactionScope based on console input
                            ConsoleKeyInfo c;
            while(true)
                            {
                Console.Write("Complete the transaction scope? [Y|N] ");
                c = Console.ReadKey();
                Console.WriteLine();
        
                                    if ((c.KeyChar == 'Y') || (c.KeyChar == 'y'))
                {
                    scope.Complete();
                    break;
                }
                else if ((c.KeyChar == 'N') || (c.KeyChar == 'n'))
                {
                    break;
                }
            }
        }
    }
    catch (System.Transactions.TransactionException ex)
    {
        Console.WriteLine(ex);
    }
    catch
    {
        Console.WriteLine("Cannot complete transaction");
        throw;
    }
}

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 Shared Sub Main()
        Try
            Using scope As TransactionScope = New TransactionScope()

                'Create an enlistment object
                Dim myEnlistmentClass As New EnlistmentClass

                'Enlist on the current transaction with the enlistment object
                Transaction.Current.EnlistVolatile(myEnlistmentClass, EnlistmentOptions.None)

                'Perform transactional work here.

                'Call complete on the TransactionScope based on console input
                Dim c As ConsoleKeyInfo
                While (True)
                    Console.Write("Complete the transaction scope? [Y|N] ")
                    c = Console.ReadKey()
                    Console.WriteLine()
                    If (c.KeyChar = "Y") Or (c.KeyChar = "y") Then
                        scope.Complete()
                        Exit While
                    ElseIf ((c.KeyChar = "N") Or (c.KeyChar = "n")) Then
                        Exit While
                    End If
                End While
            End Using
        Catch ex As TransactionException
            Console.WriteLine(ex)
        Catch
            Console.WriteLine("Cannot complete transaction")
            Throw
        End Try
    End Sub
End Class

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

Açıklamalar

Bir kaynak yöneticisinin bir işleme katılması için işlem yöneticisi aracılığıyla işleme kaydolması gerekir. Transaction Sınıfı tanımlayan bir dizi yöntem adları ile başlayan Enlist bu işlevselliği sağlar. Farklı Enlist yöntemleri karşılık farklı türde bir kaynak yöneticisi olabilir liste.

Bu sınıf, katılım için kaydolan işlem yöneticisi için iki aşamalı işleme bildirimi geri çağırmaları sağlamak üzere bir kaynak yöneticisinin uygulaması gereken bir arabirimi açıklar. Her kaynak yöneticisinin arabirimini IEnlistmentNotification uygulaması için, kaynağınızın geçici veya dayanıklı olmasına bağlı olarak, yöntemini veya EnlistDurable sınıfın Transaction yöntemini kullanarak EnlistVolatile bunu listelemeniz gerekir. Liste ve 2PC hakkında daha fazla bilgi için bkz. Kaynakları bir İşlemde Katılımcı Olarak Listeleme ve sırasıyla Single-Phase ve Çok Aşamalı İşlem İşleme .

İşlem yöneticisi, iki aşamalı işleme protokolünün farklı aşamalarında listelenmiş nesneyi aşağıdaki yöntemlerle bildirir.

Yöntem	Açıklama
Prepare	Bu listelenmiş nesne yöntemi, işlem yöneticisi katılımcılara işlemi işleyip işleyemeyeceğini sorduğunda, hareketin ilk aşamasında Transaction Manager tarafından geri çağırma olarak kullanılır.
Commit	Kayıtlı bir nesnenin bu yöntemi, işlem işlenirse işlemin ikinci aşaması sırasında Transaction Manager tarafından geri çağırma olarak kullanılır.
Rollback	Listelenmiş bir nesnenin bu yöntemi, işlem durdurulduysa (yani geri alınırsa) işlemin ikinci aşamasında transaction Manager tarafından geri çağırma olarak kullanılır.
InDoubt	Kayıtlı bir nesnenin bu yöntemi, işlemin şüpheli olması durumunda işlemin ikinci aşamasında Transaction Manager tarafından geri çağırma olarak kullanılır.

Not

Bildirimlerin sıralı olarak veya belirli bir sırada gönderilmeyebileceğini unutmayın.

Yöntemler

Commit(Enlistment)	Kayıtlı bir nesneye bir işlemin işlendiğini bildirir.
InDoubt(Enlistment)	Kayıtlı bir nesneye, işlemin durumunun şüpheli olduğunu bildirir.
Prepare(PreparingEnlistment)	Kayıtlı bir nesneye, bir işlemin taahhüt için hazırlandığını bildirir.
Rollback(Enlistment)	Bir işlemin geri alındığını (durdurulduğunu) listelenmiş bir nesneye bildirir.

Ayrıca bkz.

• ISinglePhaseNotification
• Bir İşlemde Kaynakları Katılımcı Olarak Kaydetme
• Tek Aşamalı ve Çok Aşamalı İşlem Gerçekleştirme