Message.IsFirstInTransaction Eigenschaft

  • Referenz

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

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 : bool
Public ReadOnly Property IsFirstInTransaction As Boolean

Eigenschaftswert

Boolean

true, wenn die Meldung als erste Meldung in einer Transaktion gesendet wurde, andernfalls false.

Attribute
MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

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.

Gilt für:

Weitere Informationen