共用方式為


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 實例都會受到變更的影響

如果嘗試超過佇列大小上限或計算機訊息配額,訊息可能會遺失。 達到佇列配額時,消息佇列會傳回負通知訊息,以通知傳送應用程式的系統管理佇列,以指出佇列已滿。 消息佇列會繼續傳送負通知,直到佇列中訊息的總大小低於限制為止。

下表顯示此屬性是否可在各種工作組模式中使用。

工作組模式 可用
本機電腦
本機計算機和直接格式名稱
遠端電腦
遠端電腦和直接格式名稱

適用於

另請參閱