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

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

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

MessageQueue.Transactional プロパティ

キューがトランザクションだけを受け入れるかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Transactional As Boolean

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As Boolean

value = instance.Transactional

public bool Transactional { get;
 }

C++

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

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

JScript

public function get Transactional
 () : boolean

プロパティ値
キューがトランザクションの一部として送信されるメッセージだけを受け入れる場合は true。それ以外の場合は false。

例外

例外の種類	条件
MessageQueueException	メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

トランザクションメッセージは、単一のトランザクションに関連付けられたいくつかのメッセージの組み合わせを参照します。トランザクションの一部としてメッセージを送信すると、メッセージは順番に 1 回だけ配信され、送信先キューから正常に取得できます。

非トランザクションメッセージをトランザクションキューに送信した場合は、例外が発生したときにメッセージをロールバックできません。

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

<System.MTAThreadAttribute>
 public sub Main()

Visual Basic

このプロパティが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	○
ローカルコンピュータと直接書式名	○
リモートコンピュータ	×
リモートコンピュータと直接書式名	×

使用例

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

// Display the value of the queue's Transactional property.
Console.WriteLine("MessageQueue.Transactional: {0}",
    queue.Transactional);

// Display the value of the queue's Transactional property.
Console.WriteLine("MessageQueue.Transactional: {0}", 
    System.Convert.ToString(queue.get_Transactional()));

.NET Framework のセキュリティ