MessageQueue.MaximumQueueSize プロパティ

.NET Framework クラス ライブラリ リファレンス

MessageQueue.MaximumQueueSize プロパティ

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

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property MaximumQueueSize As
 Long

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As Long

value = instance.MaximumQueueSize

instance.MaximumQueueSize = value

C#

public long MaximumQueueSize { get; set;
 }

C++

public:
property long long MaximumQueueSize {
    long long get ();
    void set (long long value);
}

J#

/** @property */
public long get_MaximumQueueSize ()

/** @property */
public void set_MaximumQueueSize (long value)

JScript

public function get MaximumQueueSize
 () : long

public function set MaximumQueueSize
 (value : long)

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

例外

例外の種類	条件
ArgumentException	最大キューサイズに負の値が含まれています。
MessageQueueException	メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

解説

MaximumQueueSize によって、メッセージ キュー メッセージ ストレージ制限にアクセスできます。これは、管理者が定義するコンピュータのメッセージ クォータとは異なります。メッセージ クォータの詳細については、MaximumJournalSize のトピックを参照してください。

このプロパティを設定すると、メッセージ キューのキューが変更されます。したがって、他の MessageQueue インスタンスが変更による影響を受けます。

最大キュー サイズまたはコンピュータのメッセージ クォータのどちらかを超えると、メッセージが失われることがあります。キュー クォータに達すると、メッセージ キューは否定受信確認メッセージを返して、キューがフルであることを送信元アプリケーションの管理キューに通知します。キューのメッセージの合計サイズが制限を下回るまで、メッセージ キューは否定受信確認を送信し続けます。

このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	○
ローカル コンピュータと直接書式名	○
リモート コンピュータ	×
リモート コンピュータと直接書式名	×

使用例

メッセージ キューの MaximumQueueSize プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// Set the queue's MaximumQueueSize property value.
queue.set_MaximumQueueSize(10);
// Display the new value of the queue's MaximumQueueSize property.
Console.WriteLine("MessageQueue.MaximumQueueSize: {0}", 
    System.Convert.ToString(queue.get_MaximumQueueSize()));

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
MessageQueue.MaximumJournalSize プロパティ
InfiniteQueueSize