ISinglePhaseNotification Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beschreibt ein Ressourcenobjekt, das die Optimierung des Commits für einzelne Phasen unterstützt, um an einer Transaktion teilzunehmen.
public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotificationpublic interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotificationtype ISinglePhaseNotification = interface
interface IEnlistmentNotificationPublic Interface ISinglePhaseNotification
Implements IEnlistmentNotification- Implementiert
Hinweise
Beachten Sie, dass auch dann, wenn Ihr Ressourcenmanager diese Schnittstelle implementiert, um die Optimierung einzelner Phasen-Commits zu unterstützen, nicht garantiert wird, dass er einen einzelnen Phasen-Commit empfängt. Der Transaktions-Manager kann stattdessen weiterhin zwei Phasen-Commitbenachrichtigungen senden.
Rufen Sie die EnlistVolatile Methode oder die EnlistDurable Methode der Transaction Klasse auf, um den Ressourcen-Manager als Teilnehmer einer Transaktion aufzurufen. Insbesondere sollte der EnlistmentOptions Parameter gleich sein None , um sicherzustellen, dass ein einzelner Phasen-Commit ausgeführt wird. Wenn sie versehentlich auf EnlistDuringPrepareRequired"Commit für einzelne Phasen" festgelegt ist, tritt kein Commit für einzelne Phasen auf.
Da die ISinglePhaseNotification Schnittstelle von der IEnlistmentNotification Schnittstelle abgeleitet wird, muss der Ressourcenmanager auch alle Methoden des letzteren für zwei Phasen-Commitbenachrichtigungen implementieren. Es ist die Wahl des Transaktionsmanagers, ob zwei Phasen commit oder die Optimierung der einzelnen Phasen mit diesem Ressourcen-Manager verwendet wird. Die Implementierung dieser Schnittstelle bietet dem Ressourcenmanager jedoch die Möglichkeit, die Optimierung zu nutzen, wenn sie verfügbar ist.
Wenn die Optimierung verwendet wird und der Transaktionsmanager die SinglePhaseCommit Methode der aufgelisteten Ressource aufruft, sollte der Ressourcenmanager mit verschiedenen Methoden der SinglePhaseEnlistment Klasse auf diesen Aufruf reagieren, um den Transaktionsmanager darüber zu informieren, ob die Transaktion zugesichert oder zurückgesetzt werden soll.
Methoden
| Name | Beschreibung |
|---|---|
| Commit(Enlistment) |
Benachrichtigt ein aufgelistetes Objekt, dass eine Transaktion zugesichert wird. (Geerbt von IEnlistmentNotification) |
| InDoubt(Enlistment) |
Benachrichtigt ein auflistenes Objekt, dass der Status einer Transaktion zweifelhaft ist. (Geerbt von IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Benachrichtigt ein aufgelistetes Objekt, dass eine Transaktion für die Verpflichtung vorbereitet wird. (Geerbt von IEnlistmentNotification) |
| Rollback(Enlistment) |
Benachrichtigt ein aufgelistetes Objekt, dass eine Transaktion zurückgesetzt wird (abgebrochen). (Geerbt von IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Stellt die Implementierung des Rückrufs für die Optimierung der einzelnen Phase des Commits des Ressourcenmanagers dar. |
