Transaction.EnlistPromotableSinglePhase Metodo

Definizione

Spazio dei nomi:

System.Transactions

Assembly:

System.Transactions.Local.dll

Inserisce un gestore risorse con una transazione interna che usa un'integrazione PSPE (Promotable Single Phase Enlistment).

Overload

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Inserisce un gestore risorse con una transazione interna che usa un'integrazione PSPE (Promotable Single Phase Enlistment).
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Inserisce un gestore risorse con una transazione interna che usa un'integrazione PSPE (Promotable Single Phase Enlistment).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Origine:

Transaction.cs

Inserisce un gestore risorse con una transazione interna che usa un'integrazione PSPE (Promotable Single Phase Enlistment).

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 di un'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 di Resource Manager. Se vengono segnalati dati incoerenti, la gestione transazioni genera un'eccezione. Se viene segnalato un InDoubt risultato, il gestore delle transazioni cerca la notifica del risultato nell'integrazione interna e ignora la risposta segnalata.

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

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Origine:

Transaction.cs

Inserisce un gestore risorse con una transazione interna che usa un'integrazione PSPE (Promotable Single Phase Enlistment).

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 di elaborazione delle transazioni distribuite.

Restituisce

Boolean

Implementazione di un'interfaccia SinglePhaseEnlistment che descrive l'integrazione.

Commenti

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

Se il valore specificato per il promoterType parametro 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 oggetto TransactionPromotionException. Queste operazioni sono:

• Transaction.EnlistDurable

• TransactionInterop.GetDtcTransaction

• TransactionInterop.GetExportCookie

• TransactionInterop.GetTransmitterPropagationToken

• Serializzazione di un oggetto Transaction