MessageQueue.BasePriority プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

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

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

プロパティ値

Int16

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

属性

MessagingDescriptionAttribute

例外

ArgumentException

基本優先順位に無効な値が設定されています。

MessageQueueException

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例では、メッセージ キュー 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 です。

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

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

こちらもご覧ください

• FormatName