MessageQueueTransaction

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

MessageQueueTransaction クラス

メッセージ キューの内部トランザクションを提供します。

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

Visual Basic (宣言)

Public Class MessageQueueTransaction
    Implements IDisposable

Visual Basic (使用法)

Dim instance As MessageQueueTransaction

C#

public class MessageQueueTransaction : IDisposable

C++

public ref class MessageQueueTransaction :
 IDisposable

J#

public class MessageQueueTransaction implements
 IDisposable

JScript

public class MessageQueueTransaction implements
 IDisposable

解説

トランザクションの一部としてメッセージを送受信するには、MessageQueueTransaction クラスを使用してトランザクションを作成し、transaction パラメータを取る MessageQueue.Send メソッドまたは MessageQueue.Receive メソッドのオーバーロードにこのトランザクションを渡します。トランザクションの一部として送信するメッセージは、トランザクション キューに送信する必要があります。トランザクション キューからのメッセージの受信は、指定されたトランザクションを使用して行う必要があります。

Receive メソッドの他、指定した ID または指定した相関 ID を使用してメッセージを受信できます。トランザクション キューからメッセージを選択的に受信する方法の詳細については、ReceiveById メソッドおよび ReceiveByCorrelationId メソッドのトピックを参照してください。

トランザクションがコミットされると、トランザクション キューに送信されたメッセージは削除されます。同様に、トランザクションがロールバックされると、トランザクション キューから受信したメッセージはキューに返されます。

MessageQueueTransaction をインスタンス化し、Send メソッドまたは Receive メソッドの適用可能なオーバーロードに渡してメッセージを非トランザクション キューに送信するか、非トランザクション キューからメッセージを受信すると、メソッドは "間違ったトランザクションの使用方法" を示す例外をスローします。

MessageQueueTransaction がスレッド アパートメントに対応しているため、アパートメントの状態が STA の場合は、複数のスレッドで同じトランザクションを使用できません。Visual Basic はメイン スレッドの状態を STA に設定するため、Main サブルーチンで MTAThreadAttribute を適用する必要があります。この処理を行っていない場合は、別のスレッドを使用してトランザクション メッセージを送信すると、MessageQueueException 例外がスローされます。MTAThreadAttribute を適用するには、次のコード片を使用します。

<System.MTAThreadAttribute>
 public sub Main()

Visual Basic

継承階層

System.Object
  System.Messaging.MessageQueueTransaction

スレッド セーフ

この型は、マルチスレッド操作に対して安全です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
MessageQueueTransaction メンバ
System.Messaging 名前空間
MessageQueue.Transactional プロパティ
MessageQueue.Send

MessageQueueTransaction コンストラクタ

MessageQueueTransaction クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New MessageQueueTransaction

C#

public MessageQueueTransaction ()

C++

public:
MessageQueueTransaction ()

J#

public MessageQueueTransaction ()

JScript

public function MessageQueueTransaction ()

解説

このコンストラクタは、Status プロパティを Initialized に設定します。

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
MessageQueueTransaction クラス
MessageQueueTransaction メンバ
System.Messaging 名前空間

MessageQueueTransaction プロパティ

パブリック プロパティ

	名前	説明
	Status	トランザクションのステータスを取得します。

参照

関連項目

MessageQueueTransaction クラス
System.Messaging 名前空間
MessageQueue.Transactional プロパティ
MessageQueue.Send

MessageQueueTransaction メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Abort	保留中の内部トランザクションをロールバックします。
	Begin	新しいメッセージ キューの内部トランザクションを開始します。
	Commit	保留中の内部トランザクションをコミットします。
	Dispose	オーバーロードされます。 MessageQueueTransaction によって使用されているリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 MessageQueueTransaction によって使用されているリソースを解放します。
	Finalize	オーバーライドされます。 現在のインスタンスに保持されているリソースを解放します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

MessageQueueTransaction クラス
System.Messaging 名前空間
MessageQueue.Transactional プロパティ
MessageQueue.Send

MessageQueueTransaction メンバ

メッセージ キューの内部トランザクションを提供します。

MessageQueueTransaction データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	MessageQueueTransaction	MessageQueueTransaction クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Status	トランザクションのステータスを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Abort	保留中の内部トランザクションをロールバックします。
	Begin	新しいメッセージ キューの内部トランザクションを開始します。
	Commit	保留中の内部トランザクションをコミットします。
	Dispose	オーバーロードされます。 MessageQueueTransaction によって使用されているリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 MessageQueueTransaction によって使用されているリソースを解放します。
	Finalize	オーバーライドされます。 現在のインスタンスに保持されているリソースを解放します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

MessageQueueTransaction クラス
System.Messaging 名前空間
MessageQueue.Transactional プロパティ
MessageQueue.Send