MessageQueue.MaximumQueueSize プロパティ

定義

キューの最大サイズを取得または設定します。

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 のインスタンスは変更の影響を受けます

キューの最大サイズまたはコンピューター のメッセージ クォータを超えようとすると、メッセージが失われる可能性があります。 キュー クォータに達すると、メッセージ キューは、負の受信確認メッセージを返すことによって、キューがいっぱいであることを示す送信アプリケーションの管理キューに通知します。 メッセージ キューは、キュー内のメッセージの合計サイズが制限を下回るまで、負の受信確認を送信し続けます。

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

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

適用対象

こちらもご覧ください