Message.IsFirstInTransaction プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

そのメッセージがトランザクションで送信された最初のメッセージかどうかを示す値を取得します。

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。

属性

MessagingDescriptionAttribute

例外

InvalidOperationException

メッセージは送信されていません。 このプロパティは、キューから取得したメッセージでだけ読み込むことができます。

- または -

メッセージ キューがフィルター処理され、IsFirstInTransaction プロパティを無視します。

例

次のコード例では、メッセージの プロパティの値を IsFirstInTransaction 表示します。

注釈

受信アプリケーションでは、 プロパティを IsFirstInTransaction 使用して、メッセージが 1 つのトランザクションで 1 つのキューに送信された最初のメッセージであることを確認します。

このプロパティは、メッセージ キュー バージョン 2.0 以降でのみ使用できます。

トランザクションの境界を確認するには、 プロパティと、 の 2 つの他のプロパティ IsLastInTransactionTransactionIdを使用IsFirstInTransactionできます。 前者を使用して、メッセージがトランザクションで最後に送信されたメッセージかどうかをチェックし、後者を使用してトランザクションの識別子を取得します。

トランザクションで送信されるメッセージが 1 つだけの場合、 IsFirstInTransaction プロパティと IsLastInTransaction プロパティの両方が に true設定されます。

こちらもご覧ください

• IsLastInTransaction
• TransactionId
• Transactional