IPromotableSinglePhaseNotification IPromotableSinglePhaseNotification IPromotableSinglePhaseNotification IPromotableSinglePhaseNotification Interface

Definition

Beschreibt ein Objekt, das als Commit-Delegat für eine nicht verteilte Transaktion in einem Ressourcen-Manager fungiert.Describes an object that acts as a commit delegate for a non-distributed transaction internal to a resource manager.

public interface class IPromotableSinglePhaseNotification : System::Transactions::ITransactionPromoter
public interface IPromotableSinglePhaseNotification : System.Transactions.ITransactionPromoter
type IPromotableSinglePhaseNotification = interface
    interface ITransactionPromoter
Public Interface IPromotableSinglePhaseNotification
Implements ITransactionPromoter
Implementiert

Hinweise

Heraufstufbare Eintragung (PSPE) ermöglichen einer Ressource, z. b. einer Datenbank, den Besitz der Transaktion zu übernehmen, wenn Sie die einzige Entität ist, die an der Transaktion teilnimmt.Promotable Enlistments (PSPE) allow a resource, such as a database, to take ownership of the transaction if it is the only entity participating in the transaction. Später kann die System.Transactions Infrastruktur bei Bedarf die Transaktion weiterhin auf MSDTC ausweiten.Later, if needed, the System.Transactions infrastructure can still escalate the transaction to MSDTC. Weitere Informationen finden Sie unter Optimization using Single Phase Commit and Promotable Single Phase Notification.For more information, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

Ein Ressourcen-Manager, der diese Schnittstelle implementiert, delegiert die Steuerung des Commits der internen nicht verteilten Transaktion an eine Eintragung für eine System.Transactions Transaktion über die EnlistPromotableSinglePhase -Methode Transaction der-Klasse.A resource manager that implements this interface delegates control of the commit of it's internal non-distributed transaction to an enlistment on a System.Transactions transaction through the EnlistPromotableSinglePhase method on the Transaction class.

Wenn die ITransactionPromoter.Promote -Methode aufgerufen wird, muss die Implementierung dieser Schnittstelle eine verteilte Transaktion in Form eines propagierungs Tokens erstellen und an System.Transactionszurückgeben.If the ITransactionPromoter.Promote method is called, your implementation of this interface must produce a distributed transaction in the form of a propagation token, and return it to System.Transactions.

Nachdem Sie ein Objekt, das diese Schnittstelle implementiert, als Teilnehmer einer Transaktion mithilfe der EnlistPromotableSinglePhase -Methode eingetragen haben, benachrichtigt der Transaktions-Manager den Teilnehmer, wenn die Transaktion herauf gestuft, übernommen oder rückgängig gemacht wird, indem aufgerufen wird.Promote -Methode, SinglePhaseCommit die-Methode oder Rollback die-Methode des-Objekts.After you enlist an object that implements this interface as a participant of a transaction using the EnlistPromotableSinglePhase method, the transaction manager then notifies the participant when the transaction is promoted, committed, or rolled back by invoking the Promote method, the SinglePhaseCommit method, or the Rollback method of the object.

Weitere Informationen finden Sie unter Optimization using Single Phase Commit and Promotable Single Phase Notification.For more information, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

Methoden

Initialize() Initialize() Initialize() Initialize()

Benachrichtigt einen Transaktionsteilnehmer, dass die Eintragung erfolgreich abgeschlossen wurde.Notifies a transaction participant that enlistment has completed successfully.

Promote() Promote() Promote() Promote()

Benachrichtigt ein eingetragenes Objekt, dass eine Eskalation der delegierten Transaktion angefordert wurde.Notifies an enlisted object that an escalation of the delegated transaction has been requested.

(Inherited from ITransactionPromoter)
Rollback(SinglePhaseEnlistment) Rollback(SinglePhaseEnlistment) Rollback(SinglePhaseEnlistment) Rollback(SinglePhaseEnlistment)

Benachrichtigt ein eingetragenes Objekt darüber, dass ein Rollback für die Transaktion ausgeführt wird.Notifies an enlisted object that the transaction is being rolled back.

SinglePhaseCommit(SinglePhaseEnlistment) SinglePhaseCommit(SinglePhaseEnlistment) SinglePhaseCommit(SinglePhaseEnlistment) SinglePhaseCommit(SinglePhaseEnlistment)

Benachrichtigt ein eingetragenes Objekt darüber, dass ein Commit für die Transaktion ausgeführt wird.Notifies an enlisted object that the transaction is being committed.

Gilt für:

Siehe auch