MessageQueue.BasePriority 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得或設定訊息佇列用來在網路上傳送公用佇列訊息的基礎優先權 (Base Priority)。

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

屬性值

Int16

傳送至 (公用) 佇列的所有訊息的單一基礎優先權。 預設為零 (0)。

屬性

MessagingDescriptionAttribute

例外狀況

ArgumentException

基礎優先權設定為無效值。

MessageQueueException

存取訊息佇列方法時發生錯誤。

範例

下列程式代碼範例會取得並設定消息佇列的 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) 。

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

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

另請參閱

• FormatName