Message.IsFirstInTransaction Eigenschaft
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.
Ruft einen Wert ab, der angibt, ob die Meldung als erste Meldung in einer Transaktion gesendet wurde.
public:
property bool IsFirstInTransaction { bool get(); };[System.Messaging.MessagingDescription("MsgIsFirstInTransaction")]
public bool IsFirstInTransaction { get; }[<System.Messaging.MessagingDescription("MsgIsFirstInTransaction")>]
member this.IsFirstInTransaction : boolPublic ReadOnly Property IsFirstInTransaction As BooleanEigenschaftswert
true, wenn die Meldung als erste Meldung in einer Transaktion gesendet wurde, andernfalls false.
- Attribute
Ausnahmen
Die Meldung wurde nicht gesendet. Diese Eigenschaft kann nur bei Meldungen gelesen werden, die aus einer Warteschlange abgerufen wurden.
- oder -
Die IsFirstInTransaction-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
Beispiele
Im folgenden Codebeispiel wird der Wert der -Eigenschaft einer Nachricht IsFirstInTransaction angezeigt.
Hinweise
Empfangende Anwendungen verwenden die IsFirstInTransaction -Eigenschaft, um zu überprüfen, ob eine Nachricht die erste Nachricht war, die in einer einzelnen Transaktion an eine einzelne Warteschlange gesendet wurde.
Diese Eigenschaft ist nur mit Message Queuing Version 2.0 und höher verfügbar.
Um Transaktionsgrenzen zu überprüfen, können Sie die IsFirstInTransaction -Eigenschaft zusammen mit zwei anderen Eigenschaften verwenden: IsLastInTransaction und TransactionId. Verwenden Sie ersteres, um zu überprüfen, ob eine Nachricht die letzte nachricht war, die in der Transaktion gesendet wurde, und verwenden Sie letztere, um den Bezeichner der Transaktion abzurufen.
Wenn nur eine Nachricht in einer Transaktion gesendet wird, werden die IsFirstInTransaction Eigenschaften und IsLastInTransaction auf truefestgelegt.
