Transaction.EnlistDurable Methode

Definition

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.

Gilt für: