Message.IsFirstInTransaction Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá hodnotu, která označuje, zda zpráva byla první zpráva odeslaná v transakci.
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
Hodnota vlastnosti
true
pokud zpráva byla první zprávou odeslanou v transakci; v opačném případě . false
- Atributy
Výjimky
Zpráva nebyla odeslána. Tuto vlastnost lze číst pouze u zpráv načtených z fronty.
-nebo-
Fronta zpráv je filtrována tak, aby ignorovala IsFirstInTransaction vlastnost.
Příklady
Následující příklad kódu zobrazí hodnotu vlastnosti zprávy IsFirstInTransaction .
Poznámky
Přijímající aplikace používají IsFirstInTransaction vlastnost k ověření, že zpráva byla první zprávou odeslanou v jedné transakci do jedné fronty.
Tato vlastnost je k dispozici pouze se službou Řízení front zpráv verze 2.0 a novější.
K ověření hranic transakcí můžete použít IsFirstInTransaction vlastnost spolu se dvěma dalšími vlastnostmi: IsLastInTransaction a TransactionId. První z nich můžete použít ke kontrole, zda zpráva byla poslední zprávou odeslanou v transakci, a použít druhou k načtení identifikátoru transakce.
Pokud je v transakci odeslána pouze jedna zpráva, IsFirstInTransaction vlastnosti a IsLastInTransaction jsou nastaveny na true
hodnotu .