Transaction.EnlistPromotableSinglePhase Metodo

Definizione

Spazio dei nomi:

System.Transactions

Assembly:

System.Transactions.Local.dll

Integra un gestore di risorse che dispone di una transazione interna usando un'integrazione di una singola fase promozionale (PSPE).

Overload

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Integra un gestore di risorse che dispone di una transazione interna usando un'integrazione di una singola fase promozionale (PSPE).
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Integra un gestore di risorse che dispone di una transazione interna usando un'integrazione di una singola fase promozionale (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Origine:

Transaction.cs

Integra un gestore di risorse che dispone di una transazione interna usando un'integrazione di una singola fase promozionale (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification);

public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification);

member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification -> bool

Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification) As Boolean

Parametri

promotableSinglePhaseNotification

IPromotableSinglePhaseNotification

Interfaccia IPromotableSinglePhaseNotification implementata dal partecipante.

Restituisce

Boolean

Implementazione dell'interfaccia SinglePhaseEnlistment che descrive l'integrazione.

Commenti

Gli inserimenti in una transazione sono volatili; cioè, non sopravvivono al fallimento del partecipante. Inoltre, questo metodo suggerisce solo al gestore transazioni di eseguire l'escalation del controllo, ma l'escalation stessa non è garantita. Se l'escalation ha esito negativo, l'utente non riceve una notifica e viene eseguito il rollback della transazione.

Il parametro promotableSinglePhaseNotification viene usato per comunicare con il gestore transazioni il risultato del tentativo di eseguire il commit della transazione interna del gestore risorse. Se vengono segnalati dati incoerenti, gestione transazioni genera un'eccezione. Se viene segnalato un risultato InDoubt, il gestore delle transazioni cerca la notifica del risultato nell'integrazione interna e ignora la risposta segnalata.

Per altre informazioni sulle integrazione e l'escalation di una transazione, vedere 'escalation di gestione delle transazioni. Per altre informazioni su PSPE, vedere Ottimizzazione tramite commit a fase singola e notifica a singola fase promozionale.

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Origine:

Transaction.cs

Integra un gestore di risorse che dispone di una transazione interna usando un'integrazione di una singola fase promozionale (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification, Guid promoterType);

public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification, Guid promoterType);

member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification * Guid -> bool

Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification, promoterType As Guid) As Boolean

Parametri

promotableSinglePhaseNotification

IPromotableSinglePhaseNotification

Interfaccia IPromotableSinglePhaseNotification implementata dal partecipante.

promoterType

Guid

Tipo del processore di transazioni distribuite.

Restituisce

Boolean

Implementazione dell'interfaccia SinglePhaseEnlistment che descrive l'integrazione.

Commenti

Se il valore specificato per il parametro promoterType è TransactionInterop.PromoterTypeDtc, la transazione deve essere promossa da MSDTC e il byte[] restituito dal metodo IPromotableSinglePhaseNotification.Promotedeve essere un token di propagazione delle transazioni MSDTC.

Se il valore specificato per il parametro promoterType è nonTransactionInterop.PromoterTypeDTC, la transazione non verrà promossa da MSDTC, ma piuttosto dall'implementazione del chiamante di IPromotableSinglePhaseNotification. Se la chiamata ha esito positivo, è presente un set di operazioni successive sulla transazione che restituirà un TransactionPromotionException. Queste operazioni sono:

• Transaction.EnlistDurable

• TransactionInterop.GetDtcTransaction

• TransactionInterop.GetExportCookie

• TransactionInterop.GetTransmitterPropagationToken

• Serializzazione di un oggetto Transaction