MessageQueue.BasePriority プロパティ

定義

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

public:
 property short BasePriority { short get(); void set(short value); };
[System.Messaging.MessagingDescription("MQ_BasePriority")]
public short BasePriority { get; set; }
[<System.Messaging.MessagingDescription("MQ_BasePriority")>]
member this.BasePriority : int16 with get, set
Public Property BasePriority As Short

プロパティ値

パブリック キューに送信されるすべてのメッセージに適用される単一の基本優先順位。 既定値は 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);

注釈

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

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

BasePriority は、形式名を使用してパスが指定されているパブリック キューにのみ適用されます。 プライベート キューの基本優先度は常に 0 です。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード 利用可能
ローカル コンピューター はい
ローカル コンピューターと直接の形式名 はい
リモート コンピューター いいえ
リモート コンピューターと直接形式の名前 いいえ

適用対象

こちらもご覧ください