MessageQueue.BasePriority 属性

定义

获取或设置基优先级,“消息队列”使用该基优先级在网络上传送公共队列的消息。

public:
 property short BasePriority { short get(); void set(short value); };
[System.Messaging.MessagingDescription("MQ_BasePriority")]
public short BasePriority { get; set; }
[<System.Messaging.MessagingDescription("MQ_BasePriority")>]
member this.BasePriority : int16 with get, set
Public Property BasePriority As Short

属性值

发送到(公共)队列的所有消息的单个基本优先级。 默认值为零 (0)。

属性

例外

基优先级被设置为无效值。

访问“消息队列”方法时出错。

示例

下面的代码示例获取并设置消息队列的 BasePriority 属性的值。

// Set the queue's BasePriority property value.
queue.BasePriority = 10;

// Display the new value of the queue's BasePriority property.
Console.WriteLine("MessageQueue.BasePriority: {0}", queue.BasePriority);

注解

消息队列的基本优先级指定路由到该队列的消息在通过网络时如何处理该消息。 可以将 属性设置为 BasePriority 将发送到指定队列的所有消息的优先级高于或低于发送到其他队列的消息。 设置此属性会修改消息队列队列。 因此,任何其他 MessageQueue 实例都会受到更改的影响。

消息队列的 BasePriority 与消息的 属性无关 Priority ,该属性指定传入消息在队列中的放置顺序。

BasePriority 仅适用于使用格式名称指定其路径的公共队列。 专用队列的基本优先级始终为零 (0) 。

下表显示了此属性在各种工作组模式下是否可用。

工作组模式 可用
本地计算机
本地计算机和直接格式名称
远程计算机
远程计算机和直接格式名称

适用于

另请参阅