IEnlistmentNotification Arabirim

Tanım

Ad Alanı:

System.Transactions

Bütünleştirilmiş Kodlar:

netstandard.dll, 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.

C#

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 .

C#

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();
    }
}

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.

Şunlara uygulanır

Ayrıca bkz.

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