Message.IsFirstInTransaction Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

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

Boolean

truepokud zpráva byla první zprávou odeslanou v transakci; v opačném případě . false

Atributy

MessagingDescriptionAttribute

Výjimky

InvalidOperationException

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 truehodnotu .

Viz také

• IsLastInTransaction
• TransactionId
• Transactional