IEnlistmentNotification.Prepare(PreparingEnlistment) Methode

Definitie

Hiermee wordt een in een lijst geplaatst object aangegeven dat een transactie wordt voorbereid op toezegging.

public:
 void Prepare(System::Transactions::PreparingEnlistment ^ preparingEnlistment);
public void Prepare(System.Transactions.PreparingEnlistment preparingEnlistment);
abstract member Prepare : System.Transactions.PreparingEnlistment -> unit
Public Sub Prepare (preparingEnlistment As PreparingEnlistment)

Parameters

preparingEnlistment
PreparingEnlistment

Een PreparingEnlistment object dat wordt gebruikt om een antwoord naar de transactiebeheerder te verzenden.

Opmerkingen

De transactiebeheerder roept deze methode aan van een in de lijst vermelde resourcemanager tijdens fase 1 van een toezegging, wanneer deelnemers worden gevraagd of ze de transactie kunnen doorvoeren.

Wanneer u een duurzame resourcemanager implementeert, moet u uw voorbereidingsrecord registreren tijdens deze fase. De record moet alle benodigde informatie bevatten om herstel uit te voeren. Dit omvat de RecoveryInformation() eigenschap, die wordt doorgegeven aan de transactiebeheerder in de methode tijdens het Reenlist herstel. Zie Herstel uitvoeren voor meer informatie over herstel.

Uw resourcemanager moet alle werkzaamheden voltooien die moeten worden voltooid voordat u de methode van de parameter aanroept om aan Prepared te geven dat de preparingEnlistment parameter moet stemmen op toezegging. Zorg ervoor dat dit wordt bereikt voordat u fase 2-meldingen ontvangt, zoals doorvoeren, terugdraaien of twijfelen. Dit komt doordat fase 2-meldingen inline kunnen plaatsvinden op dezelfde thread die de Prepared methode in fase 1 wordt genoemd. Als zodanig moet u geen werk doen na de Prepared aanroep (bijvoorbeeld het vrijgeven van vergrendelingen) die u verwacht te hebben voltooid voordat u de meldingen van fase 2 ontvangt.

U kunt ook de methode van de preparingEnlistment parameter aanroepen om een stem voor terugdraaiactie aan te geven.

Als u wilt dat het object alleen de voortgang van de transactie bekijkt en erop reageert, zonder hieraan deel te nemen, moet uw implementatie van deze methode de Done methode van de preparingEnlistment parameter aanroepen wanneer het zijn werk heeft voltooid. Als u dit doet, ontvangt uw resourcemanager geen melding van fase 2.

Van toepassing op