ISinglePhaseNotification Interface

Definitie

Beschrijft een resourceobject dat optimalisatie van één fase doorvoer ondersteunt om deel te nemen aan een transactie.

public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotification
public interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotification
type ISinglePhaseNotification = interface
    interface IEnlistmentNotification
Public Interface ISinglePhaseNotification
Implements IEnlistmentNotification
Implementeringen

Opmerkingen

Houd er rekening mee dat zelfs wanneer uw Resource Manager deze interface implementeert ter ondersteuning van optimalisatie van één fase doorvoeren, het niet gegarandeerd is dat er één fasedoorvoering wordt doorgevoerd. De transactiebeheerder kan in plaats daarvan nog steeds twee fasedoorvoermeldingen verzenden.

Als u uw resourcemanager wilt inschakelen als deelnemer aan een transactie, roept u de EnlistVolatile methode of de EnlistDurable methode van de Transaction klasse aan. EnlistmentOptions De parameter moet met name gelijk zijn aan None om ervoor te zorgen dat één fasedoorvoering wordt uitgevoerd. Als deze per ongeluk is ingesteld EnlistDuringPrepareRequiredop, vindt er geen enkele fasedoorvoering plaats.

Omdat de ISinglePhaseNotification interface is afgeleid van de IEnlistmentNotification interface, moet de resourcemanager ook alle methoden van de laatste implementeren voor meldingen over twee fasen doorvoeren. Het is de keuze van de transactiebeheerder om te bepalen of er twee fasen doorvoeren of de optimalisatie van één fase doorvoeren wordt gebruikt met deze Resource Manager. Het implementeren van deze interface biedt resourcemanager echter de mogelijkheid om te profiteren van de optimalisatie wanneer deze beschikbaar is.

Als de optimalisatie wordt gebruikt en de transactiebeheerder de SinglePhaseCommit methode van de vermelde resource aanroept, moet de resourcemanager reageren op deze aanroep met behulp van verschillende methoden van de SinglePhaseEnlistment klasse om de transactiebeheerder te informeren als de transactie moet worden doorgevoerd of teruggedraaid.

Methoden

Name Description
Commit(Enlistment)

Hiermee wordt een in een lijst geplaatst object aangegeven dat een transactie wordt doorgevoerd.

(Overgenomen van IEnlistmentNotification)
InDoubt(Enlistment)

Hiermee wordt een in een lijst opgenomen object aangegeven dat de status van een transactie twijfelachtig is.

(Overgenomen van IEnlistmentNotification)
Prepare(PreparingEnlistment)

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

(Overgenomen van IEnlistmentNotification)
Rollback(Enlistment)

Hiermee wordt een in een lijst geplaatst object aangegeven dat een transactie wordt teruggedraaid (afgebroken).

(Overgenomen van IEnlistmentNotification)
SinglePhaseCommit(SinglePhaseEnlistment)

Vertegenwoordigt de implementatie van de resourcemanager van de callback voor de optimalisatie van één fase doorvoer.

Van toepassing op

Zie ook