Message.IsFirstInTransaction Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera wartość wskazującą, czy komunikat był pierwszym komunikatem wysłanym w transakcji.

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

Wartość właściwości

Boolean

true jeśli komunikat był pierwszą wiadomością wysłaną w transakcji; w przeciwnym razie , false.

Atrybuty
MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

Wiadomość nie została wysłana. Tę właściwość można odczytywać tylko w przypadku komunikatów pobranych z kolejki.

-lub- Kolejka komunikatów jest filtrowana w celu zignorowania IsFirstInTransaction właściwości .

Przykłady

Poniższy przykład kodu wyświetla wartość właściwości komunikatu IsFirstInTransaction .

Uwagi

Odbieranie aplikacji używa IsFirstInTransaction właściwości , aby sprawdzić, czy komunikat był pierwszym komunikatem wysłanym w jednej transakcji do pojedynczej kolejki.

Ta właściwość jest dostępna tylko w przypadku kolejkowania komunikatów w wersji 2.0 lub nowszej.

Aby sprawdzić granice transakcji, możesz użyć IsFirstInTransaction właściwości wraz z dwiema innymi właściwościami: IsLastInTransaction i TransactionId. Użyj poprzedniego, aby sprawdzić, czy komunikat był ostatnią wiadomością wysłaną w transakcji, i użyj tej drugiej, aby pobrać identyfikator transakcji.

Jeśli tylko jeden komunikat jest wysyłany w transakcji, IsFirstInTransaction właściwości i IsLastInTransaction są ustawione na truewartość .

Dotyczy

Zobacz też