IPromotableSinglePhaseNotification Schnittstelle

Definition

Namespace:

System.Transactions

Assembly:

System.Transactions.Local.dll

Beschreibt ein Objekt, das als Commit-Delegat für eine nicht verteilte Transaktion in einem Ressourcen-Manager fungiert.

public interface class IPromotableSinglePhaseNotification : System::Transactions::ITransactionPromoter

public interface IPromotableSinglePhaseNotification : System.Transactions.ITransactionPromoter

type IPromotableSinglePhaseNotification = interface
    interface ITransactionPromoter

Public Interface IPromotableSinglePhaseNotification
Implements ITransactionPromoter

Implementiert

ITransactionPromoter

Hinweise

Promotable Enlistments (PSPE) ermöglichen es einer Ressource, z. B. einer Datenbank, den Besitz an der Transaktion zu übernehmen, wenn sie die einzige Entität ist, die an der Transaktion teilnimmt. Später, falls erforderlich, kann die System.Transactions Infrastruktur die Transaktion weiterhin an MSDTC eskalieren. Weitere Informationen finden Sie unter Optimierung mithilfe von Single Phase Commit und Promotable Single Phase Notification.

Ein Ressourcen-Manager, der diese Schnittstelle implementiert, delegiert die Steuerung des Commits der internen nicht verteilten Transaktion an eine Registrierung für eine System.Transactions Transaktion über die EnlistPromotableSinglePhase -Methode für die Transaction -Klasse.

Wenn die ITransactionPromoter.Promote -Methode aufgerufen wird, muss ihre Implementierung dieser Schnittstelle eine verteilte Transaktion in Form eines Weitergabetokens erzeugen und an System.Transactionszurückgeben.

Nachdem Sie ein Objekt hinzugefügt haben, das diese Schnittstelle als Teilnehmer einer Transaktion mithilfe der EnlistPromotableSinglePhase -Methode implementiert, benachrichtigt der Transaktions-Manager den Teilnehmer, wenn die Transaktion höhergestuft, gebunden oder ein Rollback ausgeführt wird, indem die Promote -Methode, - SinglePhaseCommit Methode oder - Rollback Methode des -Objekts aufgerufen wird.

Weitere Informationen finden Sie unter Optimierung mithilfe von Single Phase Commit und Promotable Single Phase Notification.

Methoden

Initialize()	Benachrichtigt einen Transaktionsteilnehmer, dass die Eintragung erfolgreich abgeschlossen wurde.
Promote()	Benachrichtigt ein eingetragenes Objekt, dass eine Eskalation der delegierten Transaktion angefordert wurde. (Geerbt von ITransactionPromoter)
Rollback(SinglePhaseEnlistment)	Benachrichtigt ein eingetragenes Objekt darüber, dass ein Rollback für die Transaktion ausgeführt wird.
SinglePhaseCommit(SinglePhaseEnlistment)	Benachrichtigt ein eingetragenes Objekt darüber, dass ein Commit für die Transaktion ausgeführt wird.

Weitere Informationen

• Transaction
• Optimierung mithilfe von Single Phase Commit und Promotable Single Phase Notification