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