MessageQueue.BasePriority プロパティ

.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

C#

public short BasePriority { get; set;
 }

C++

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

J#

/** @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 プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// 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()));

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

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