Message.TransactionId プロパティ

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

Message.TransactionId プロパティ

一部にメッセージを含むトランザクションの ID を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 TransactionId As String

Visual Basic (使用法)

Dim instance As Message
Dim value As String

value = instance.TransactionId

C#

public string TransactionId { get;
 }

C++

public:
property String^ TransactionId {
    String^ get ();
}

J#

/** @property */
public String get_TransactionId ()

JScript

public function get TransactionId
 () : String

プロパティ値
メッセージに関連付けられているトランザクションの ID。

例外

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

解説

受信側アプリケーションは、メッセージが特定のトランザクションの一部として送信されたかどうかを確認するために TransactionId プロパティを使います。トランザクション ID は、送信元コンピュータの ID (最初の 16 ビット) と、それに続く 4 バイトのトランザクション シーケンス番号で構成されます。

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

トランザクション シーケンス番号は永続的ではなく、2²⁰ を超えると再び最初から割り当てられるため、トランザクション ID が一意であるという保証はありません。メッセージ キューが保証することは、続いて発生するトランザクションの番号を異なるシーケンス番号にすることだけです。

トランザクションの境界を確認するために TransactionId プロパティと共に使用できるプロパティは、IsFirstInTransaction と IsLastInTransaction です。

使用例

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

C#

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

C++

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

J#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.IsFirstInTransaction プロパティ
Message.IsLastInTransaction プロパティ
Transactional