Message.IsFirstInTransaction プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Message.IsFirstInTransaction プロパティ

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

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 IsFirstInTransaction As Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.IsFirstInTransaction

public bool IsFirstInTransaction { get;
 }

C++

public:
property bool IsFirstInTransaction {
    bool get ();
}

/** @property */
public boolean get_IsFirstInTransaction ()

JScript

public function get IsFirstInTransaction
 () : boolean

プロパティ値
そのメッセージがトランザクションで送信された最初のメッセージである場合は true。それ以外の場合は false。

例外

例外の種類	条件
InvalidOperationException	メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。またはフィルタ処理されたメッセージキューが、IsFirstInTransaction プロパティを無視します。

例外の種類

条件

InvalidOperationException

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

または

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

解説

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

このプロパティは、メッセージキュー Version 2.0 以降でだけ使用できます。

トランザクションの境界を確認するために IsFirstInTransaction プロパティと共に使用できるプロパティは、IsLastInTransaction と TransactionId です。前者はメッセージがトランザクションで送信された最後のメッセージかどうかを確認するために使用し、後者はトランザクションの ID を取得するために使用します。

トランザクション内で送信されたメッセージが 1 つだけであるときは、IsFirstInTransaction プロパティと IsLastInTransaction プロパティは、どちらも true に設定されます。

使用例

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

// Display the value of the message's IsFirstInTransaction property.
// To view this property value, the queue's
// MessageReadPropertyFilter.IsFirstInTransaction property must be set
// to true before the message is received.
Console.WriteLine("Message.IsFirstInTransaction: {0}",
    orderMessage.IsFirstInTransaction);

C++

// Display the value of the message's IsFirstInTransaction property.
// To view this property value, the queue's
// MessageReadPropertyFilter.IsFirstInTransaction property must be set
// to true before the message is received.
Console::WriteLine("Message.IsFirstInTransaction: {0}",
    orderMessage->IsFirstInTransaction);

// Display the value of the message's IsFirstInTransaction property.
// To view this property value, the queue's
// MessageReadPropertyFilter.IsFirstInTransaction property must be set
// to true before the message is received.
Console.WriteLine("Message.IsFirstInTransaction: {0}", 
    System.Convert.ToString(orderMessage.get_IsFirstInTransaction()));