Message.IsFirstInTransaction プロパティ
そのメッセージがトランザクションで送信された最初のメッセージかどうかを示す値を取得します。
Public ReadOnly Property IsFirstInTransaction As Boolean
[C#]
public bool IsFirstInTransaction {get;}
[C++]
public: __property bool get_IsFirstInTransaction();
[JScript]
public function get IsFirstInTransaction() : Boolean;
プロパティ値
そのメッセージがトランザクションで送信された最初のメッセージである場合は true 。それ以外の場合は false 。
例外
例外の種類 | 条件 |
---|---|
InvalidOperationException | メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。
または フィルタ処理されたメッセージ キューが、 IsFirstInTransaction プロパティを無視します。 |
解説
受信側アプリケーションは、そのメッセージが 1 つのトランザクションで 1 つのキューに送信された最初のメッセージかどうかを IsFirstInTransaction プロパティを使って確認します。
メモ このプロパティは、メッセージ キュー 2.0 以降のバージョンでだけ使用できます。
トランザクションの境界を確認するために IsFirstInTransaction プロパティと共に使用できるプロパティは、 IsLastInTransaction と TransactionId です。前者はメッセージがトランザクションで送信された最後のメッセージかどうかを確認するために使用し、後者はトランザクションの ID を取得するために使用します。
トランザクション内で送信されたメッセージが 1 つだけであるときは、 IsFirstInTransaction プロパティと IsLastInTransaction プロパティは、どちらも true に設定されます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
Message クラス | Message メンバ | System.Messaging 名前空間 | IsLastInTransaction | TransactionId | Transactional