Message.IsFirstInTransaction 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得值，指出訊息是否為交易中最先傳送的訊息。

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

Boolean

如果訊息是異動中最先傳送的訊息為 true，否則為 false。

未傳送訊息。這個屬性只能在從佇列擷取的訊息中讀取。

-或-

篩選訊息佇列以忽略 IsFirstInTransaction 屬性。

下列程式代碼範例會顯示訊息 IsFirstInTransaction 的屬性值。

接收應用程式會 IsFirstInTransaction 使用屬性來確認訊息是單一交易中傳送至單一佇列的第一個訊息。

此屬性僅適用於消息佇列 2.0 版和更新版本。

若要驗證交易界限，您可以使用 IsFirstInTransaction 屬性與其他兩個屬性： IsLastInTransaction 和 TransactionId。使用前者來檢查訊息是否為交易中傳送的最後一則訊息，並使用後者來擷取交易的標識碼。

如果交易中只傳送一則訊息， IsFirstInTransaction 和 IsLastInTransaction 屬性都會設定為 true。