Transaction.EnlistDurable Método

  • Referência

Definição

Namespace:
System.Transactions
Assembly:
System.Transactions.Local.dll
Assembly:
System.Transactions.dll
Assembly:
netstandard.dll

Inscreve um Resource Manager durável para participar de uma transação.

Sobrecargas

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

Inscreve um gerenciador de recursos durável que dá suporte à confirmação em duas fases para participar de uma transação.
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

Inscreve um Resource Manager durável que dá suporte à otimização em fase única para participar de uma transação.

Comentários

Nota Esse método usa LinkDemand para impedir que ele seja chamado de código não confiável; no entanto, somente o chamador imediato é necessário para possuir o FullTrust conjunto de permissões.

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

Inscreve um gerenciador de recursos durável que dá suporte à confirmação em duas fases para participar de uma transação.

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::IEnlistmentNotification ^ enlistmentNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid manager, System::Transactions::IEnlistmentNotification ^ notification, System::Transactions::EnlistmentOptions options);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.IEnlistmentNotification enlistmentNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
public System.Transactions.Enlistment EnlistDurable (Guid manager, System.Transactions.IEnlistmentNotification notification, System.Transactions.EnlistmentOptions options);
member this.EnlistDurable : Guid * System.Transactions.IEnlistmentNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
member this.EnlistDurable : Guid * System.Transactions.IEnlistmentNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (resourceManagerIdentifier As Guid, enlistmentNotification As IEnlistmentNotification, enlistmentOptions As EnlistmentOptions) As Enlistment
Public Function EnlistDurable (manager As Guid, notification As IEnlistmentNotification, options As EnlistmentOptions) As Enlistment

Parâmetros

resourceManagerIdentifiermanager
Guid

’Um identificador exclusivo de um gerenciador de recursos, que deve persistir durante uma falha ou reinicialização do gerenciador de recursos.

enlistmentNotificationnotification
IEnlistmentNotification

Um objeto que implementa a interface IEnlistmentNotification para receber duas notificações de confirmação de fase.

enlistmentOptionsoptions
EnlistmentOptions

EnlistDuringPrepareRequired se o gerenciador de recursos desejar realizar trabalho adicional durante a fase de preparação.

Retornos

Enlistment

Um objeto Enlistment que descreve a inscrição.

Comentários

Os gerenciadores de recursos com um alistamento durável devem ser capazes de executar a recuperação se tiverem uma falha. Para obter mais informações sobre a recuperação, consulte Executar Recuperação. Para obter mais informações sobre recursos voláteis e duráveis, bem como como inscrever um recurso, consulte Implementando um Resource Manager. Para obter mais informações sobre como um gerenciador de recursos responde à notificação de confirmação e preparar a confirmação em duas fases, consulte Confirmando uma transação em Single-Phase e em várias fases.

Os gerenciador de recursos inscritos para participação em uma transação por meio desse método recebem duas notificações de confirmação de fase que correspondem aos métodos definidos na IEnlistmentNotification interface.

Aplica-se a

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

Inscreve um Resource Manager durável que dá suporte à otimização em fase única para participar de uma transação.

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::ISinglePhaseNotification ^ singlePhaseNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid manager, System::Transactions::ISinglePhaseNotification ^ notification, System::Transactions::EnlistmentOptions options);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.ISinglePhaseNotification singlePhaseNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
public System.Transactions.Enlistment EnlistDurable (Guid manager, System.Transactions.ISinglePhaseNotification notification, System.Transactions.EnlistmentOptions options);
member this.EnlistDurable : Guid * System.Transactions.ISinglePhaseNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
member this.EnlistDurable : Guid * System.Transactions.ISinglePhaseNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (resourceManagerIdentifier As Guid, singlePhaseNotification As ISinglePhaseNotification, enlistmentOptions As EnlistmentOptions) As Enlistment
Public Function EnlistDurable (manager As Guid, notification As ISinglePhaseNotification, options As EnlistmentOptions) As Enlistment

Parâmetros

resourceManagerIdentifiermanager
Guid

’Um identificador exclusivo de um gerenciador de recursos, que deve persistir durante uma falha ou reinicialização do gerenciador de recursos.

singlePhaseNotificationnotification
ISinglePhaseNotification

Um objeto que implementa a interface ISinglePhaseNotification, a qual deve ser capaz de receber notificações de confirmação em uma e em duas fases.

enlistmentOptionsoptions
EnlistmentOptions

EnlistDuringPrepareRequired se o gerenciador de recursos desejar realizar trabalho adicional durante a fase de preparação.

Retornos

Enlistment

Um objeto Enlistment que descreve a inscrição.

Comentários

Os gerenciadores de recursos com um alistamento durável devem ser capazes de executar a recuperação se tiverem uma falha. Para obter mais informações sobre a recuperação, consulte Executar Recuperação. Para obter mais informações sobre recursos voláteis e duráveis, bem como como inscrever um recurso, consulte Implementando um Resource Manager.

Você deve observar que, mesmo quando a implementação do gerenciador de recursos se inseri com esse método, não é garantido que ele receba uma confirmação de fase única. Em vez disso, o gerenciador de transações ainda pode enviar duas notificações de confirmação de fase. Para obter mais informações sobre a otimização de confirmação de fase única, consulte Otimização usando confirmação de fase única e notificação de fase única promovível.

Aplica-se a