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

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

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

MessageQueue.BasePriority プロパティ

ネットワーク上でパブリックキューのメッセージを送信するためにメッセージキューが使用する基本優先順位を取得または設定します。

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

Visual Basic (宣言)

Public Property BasePriority As
 Short

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As Short

value = instance.BasePriority

instance.BasePriority = value

public short BasePriority { get; set;
 }

C++

public:
property short BasePriority {
    short get ();
    void set (short value);
}

/** @property */
public short get_BasePriority ()

/** @property */
public void set_BasePriority (short value)

JScript

public function get BasePriority
 () : short

public function set BasePriority
 (value : short)

プロパティ値
(パブリック) キューに送信されるすべてのメッセージに適用される単一の基本優先順位。既定値は 0 です。

例外

例外の種類	条件
ArgumentException	基本優先順位に無効な値が設定されています。
MessageQueueException	メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

メッセージキューの基本優先順位は、そのキューに到達するまでにネットワークでメッセージを処理する方法を指定します。BasePriority プロパティを設定すると、指定したキューに送信されるすべてのメッセージの優先順位を他のキューに送信されるメッセージよりも高くまたは低くできます。このプロパティを設定すると、メッセージキューのキューが変更されます。したがって、他の MessageQueue インスタンスが変更による影響を受けます。

メッセージキューの BasePriority は、メッセージの Priority プロパティとは関係ありません。このメッセージのプロパティは、着信メッセージをキューに配置する順序を指定します。

BasePriority は、書式名を使用して指定されたパスのパブリックキューにだけ適用されます。プライベートキューの基本優先順位は常に 0 です。

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

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

使用例

メッセージキューの BasePriority プロパティに対し、値の取得と設定を行うコード例を次に示します。

// Set the queue's BasePriority property value.
queue.BasePriority = 10;

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

// Set the queue's BasePriority property value.
queue.set_BasePriority((short)10);
// Display the new value of the queue's BasePriority property.
Console.WriteLine("MessageQueue.BasePriority: {0}", 
    System.Convert.ToString(queue.get_BasePriority()));