Udostępnij za pośrednictwem

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 wiadomość była pierwszą wiadomością wysłaną w transakcji; w przeciwnym razie , false.

Atrybuty
MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

Wiadomość nie została wysłana. Ta właściwość może być odczytywana tylko w komunikatach pobranych z kolejki.

-lub-

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

Przykłady

Poniższy przykład kodu przedstawia 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 zweryfikować granice transakcji, można 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 tego ostatniego, 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ż