ISinglePhaseNotification Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Beskriver ett resursobjekt som stöder enfasincheckningsoptimering för att delta i en transaktion.
public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotificationpublic interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotificationtype ISinglePhaseNotification = interface
interface IEnlistmentNotificationPublic Interface ISinglePhaseNotification
Implements IEnlistmentNotification- Implementeringar
Kommentarer
Observera att även om din resurshanterare implementerar det här gränssnittet för att stödja optimering av enfasincheckning är det inte garanterat att den får en enda fasincheckning. Transaktionshanteraren kan fortfarande skicka två fasincheckningsmeddelanden i stället.
Om du vill registrera resurshanteraren som deltagare i en transaktion anropar EnlistVolatile du -metoden eller EnlistDurable -metoden för Transaction klassen. Mer specifikt bör parametern EnlistmentOptions vara lika med None för att säkerställa att en enskild fasincheckning utförs. Om den av misstag har angetts till EnlistDuringPrepareRequiredsker ingen enskild fasincheckning.
ISinglePhaseNotification Eftersom gränssnittet härleds från IEnlistmentNotification gränssnittet måste resurshanteraren även implementera alla metoder för det senare för två fasincheckningsmeddelanden. Det är transaktionshanterarens val om två fasincheckning eller optimering av en fasincheckning används med den här resurshanteraren. Att implementera det här gränssnittet ger dock resurshanteraren möjlighet att dra nytta av optimeringen när den är tillgänglig.
Om optimeringen används och transaktionshanteraren anropar SinglePhaseCommit metoden för den registrerade resursen bör resurshanteraren svara på det här anropet med hjälp av olika metoder i SinglePhaseEnlistment klassen för att informera transaktionshanteraren om transaktionen ska checkas in eller återställas.
Metoder
| Name | Description |
|---|---|
| Commit(Enlistment) |
Meddelar ett listat objekt att en transaktion checkas in. (Ärvd från IEnlistmentNotification) |
| InDoubt(Enlistment) |
Meddelar ett registrerat objekt att statusen för en transaktion är osäker. (Ärvd från IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Meddelar ett listat objekt att en transaktion förbereds för åtagande. (Ärvd från IEnlistmentNotification) |
| Rollback(Enlistment) |
Meddelar ett listat objekt att en transaktion återställs (avbryts). (Ärvd från IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Representerar resource manager-implementeringen av återanropet för optimering av enfasincheckning. |
