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 です。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
ワークグループ モード | 利用可能 |
---|---|
ローカル コンピューター | はい |
ローカル コンピューターと直接形式名 | はい |
リモート コンピューター | いいえ |
リモート コンピューターと直接形式の名前 | いいえ |