Transaction.EnlistDurable Methode
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.
Trägt einen permanenten Ressourcen-Manager ein, der an einer Transaktion beteiligt sein soll.
Überlädt
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) |
Trägt einen permanenten Ressourcen-Manager ein, der das Zwei-Phasen-Commit unterstützt und an einer Transaktion beteiligt sein soll. |
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) |
Trägt einen permanenten Ressourcen-Manager ein, der das Optimieren eines Ein-Phasen-Commits unterstützt und an einer Transaktion beteiligt sein soll. |
Hinweise
Hinweis
Diese Methode verwendet LinkDemand , um zu verhindern, dass sie von nicht vertrauenswürdigem Code aufgerufen wird. Es ist jedoch nur der sofortige Aufrufer erforderlich, um den FullTrust
Berechtigungssatz zu besitzen.
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)
- Quelle:
- Transaction.cs
- Quelle:
- Transaction.cs
- Quelle:
- Transaction.cs
Trägt einen permanenten Ressourcen-Manager ein, der das Zwei-Phasen-Commit unterstützt und an einer Transaktion beteiligt sein soll.
public:
System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::IEnlistmentNotification ^ enlistmentNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.IEnlistmentNotification enlistmentNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
member this.EnlistDurable : Guid * System.Transactions.IEnlistmentNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (resourceManagerIdentifier As Guid, enlistmentNotification As IEnlistmentNotification, enlistmentOptions As EnlistmentOptions) As Enlistment
Parameter
- resourceManagerIdentifier
- Guid
Ein eindeutiger Bezeichner für einen Ressourcen-Manager, der bei einem Fehler oder Neustart des Ressourcen-Managers erhalten bleiben soll.
- enlistmentNotification
- IEnlistmentNotification
Ein Objekt, das die IEnlistmentNotification-Schnittstelle implementiert, um Benachrichtigungen über Zwei-Phasen-Commits zu empfangen.
- enlistmentOptions
- EnlistmentOptions
EnlistDuringPrepareRequired, wenn der Ressourcen-Manager während der Vorbereitungsphase zusätzliche Arbeiten ausführen möchte.
Gibt zurück
Ein Enlistment-Objekt, das die Eintragung beschreibt.
Hinweise
Ressourcenmanager mit einer dauerhaften Eintragung müssen in der Lage sein, eine Wiederherstellung durchzuführen, wenn ein Fehler auftritt. Weitere Informationen zur Wiederherstellung finden Sie unter Ausführen der Wiederherstellung. Weitere Informationen zu flüchtigen und dauerhaften Ressourcen sowie zum Eintragen einer Ressource finden Sie unter Implementieren einer Resource Manager. Weitere Informationen dazu, wie ein Ressourcen-Manager auf eine Commitbenachrichtigung reagiert und den Commit in zwei Phasen vorbereitet, finden Sie unter Commiten einer Transaktion in Single-Phase und Mehrphasen.
Ressourcenmanager, die für die Teilnahme an einer Transaktion über diese Methode eingetragen sind, erhalten zwei Phasencommitbenachrichtigungen, die den auf der IEnlistmentNotification Schnittstelle definierten Methoden entsprechen.
Gilt für:
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)
- Quelle:
- Transaction.cs
- Quelle:
- Transaction.cs
- Quelle:
- Transaction.cs
Trägt einen permanenten Ressourcen-Manager ein, der das Optimieren eines Ein-Phasen-Commits unterstützt und an einer Transaktion beteiligt sein soll.
public:
System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::ISinglePhaseNotification ^ singlePhaseNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.ISinglePhaseNotification singlePhaseNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
member this.EnlistDurable : Guid * System.Transactions.ISinglePhaseNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (resourceManagerIdentifier As Guid, singlePhaseNotification As ISinglePhaseNotification, enlistmentOptions As EnlistmentOptions) As Enlistment
Parameter
- resourceManagerIdentifier
- Guid
Ein eindeutiger Bezeichner für einen Ressourcen-Manager, der bei einem Fehler oder Neustart des Ressourcen-Managers erhalten bleiben soll.
- singlePhaseNotification
- ISinglePhaseNotification
Ein Objekt, das die ISinglePhaseNotification-Schnittstelle implementiert, die für den Empfang von Benachrichtigungen über Ein- und Zwei-Phasen-Commits geeignet sein muss.
- enlistmentOptions
- EnlistmentOptions
EnlistDuringPrepareRequired, wenn der Ressourcen-Manager während der Vorbereitungsphase zusätzliche Arbeiten ausführen möchte.
Gibt zurück
Ein Enlistment-Objekt, das die Eintragung beschreibt.
Hinweise
Ressourcenmanager mit einer dauerhaften Eintragung müssen in der Lage sein, eine Wiederherstellung durchzuführen, wenn ein Fehler auftritt. Weitere Informationen zur Wiederherstellung finden Sie unter Ausführen der Wiederherstellung. Weitere Informationen zu flüchtigen und dauerhaften Ressourcen sowie zum Eintragen einer Ressource finden Sie unter Implementieren einer Resource Manager.
Sie sollten beachten, dass selbst wenn Sich Ihre Resource Manager-Implementierung mit dieser Methode eintragen lässt, nicht garantiert ist, dass sie einen Commit in einer einzelnen Phase empfängt. Der Transaktions-Manager kann stattdessen weiterhin commit-Benachrichtigungen in zwei Phasen senden. Weitere Informationen zur Optimierung des einstufigen Commits finden Sie unter Optimierung mithilfe von Single Phase Commit und Promotable Single Phase Notification.For more information on the single phase commit optimization, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.