MessageQueue.MaximumQueueSize プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キューの最大サイズを取得または設定します。
public:
property long MaximumQueueSize { long get(); void set(long value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.SizeConverter))]
[System.Messaging.MessagingDescription("MQ_MaximumQueueSize")]
public long MaximumQueueSize { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.SizeConverter))>]
[<System.Messaging.MessagingDescription("MQ_MaximumQueueSize")>]
member this.MaximumQueueSize : int64 with get, set
Public Property MaximumQueueSize As Long
プロパティ値
キューの最大サイズ。単位は KB です。 メッセージ キューの既定値は、制限なしです。
- 属性
例外
最大キューサイズに負の値が含まれています。
メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。
例
次のコード例では、メッセージ キュー MaximumQueueSize の プロパティの値を取得および設定します。
// Set the queue's MaximumQueueSize property value.
queue.MaximumQueueSize = 10;
// Display the new value of the queue's MaximumQueueSize property.
Console.WriteLine("MessageQueue.MaximumQueueSize: {0}",
queue.MaximumQueueSize);
注釈
は MaximumQueueSize 、管理者が定義するコンピューターのメッセージ クォータとは別のメッセージ キュー メッセージストレージ制限へのアクセスを提供します。 メッセージ クォータの詳細については、「」を参照してください MaximumJournalSize。
このプロパティを設定すると、メッセージ キュー キューが変更されます。 そのため、その他 MessageQueue のインスタンスは変更の影響を受けます
キューの最大サイズまたはコンピューター のメッセージ クォータを超えようとすると、メッセージが失われる可能性があります。 キュー クォータに達すると、メッセージ キューは、負の受信確認メッセージを返すことによって、キューがいっぱいであることを示す送信アプリケーションの管理キューに通知します。 メッセージ キューは、キュー内のメッセージの合計サイズが制限を下回るまで、負の受信確認を送信し続けます。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
ワークグループ モード | 利用可能 |
---|---|
ローカル コンピューター | はい |
ローカル コンピューターと直接の形式名 | はい |
リモート コンピューター | いいえ |
リモート コンピューターと直接形式の名前 | いいえ |
適用対象
こちらもご覧ください
.NET