MessageQueue.MaximumQueueSize プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

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

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

プロパティ値

Int64

キューの最大サイズ。単位は KB です。 メッセージ キューの既定値は、制限なしです。

属性

TypeConverterAttribute MessagingDescriptionAttribute

例外

ArgumentException

最大キューサイズに負の値が含まれています。

MessageQueueException

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

例

次のコード例では、メッセージ キュー 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 のインスタンスは変更の影響を受けます

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

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

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

こちらもご覧ください

• MaximumJournalSize
• InfiniteQueueSize