MessageQueue.BasePriority プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ネットワーク上でパブリック キューのメッセージを送信するためにメッセージ キューが使用する基本優先順位を取得または設定します。
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 です。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
ワークグループ モード | 利用可能 |
---|---|
ローカル コンピューター | はい |
ローカル コンピューターと直接の形式名 | はい |
リモート コンピューター | いいえ |
リモート コンピューターと直接形式の名前 | いいえ |
適用対象
こちらもご覧ください
.NET