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

队列的最大大小，以千字节为单位。 “消息队列”默认设置指定：不存在任何限制。

属性

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