MessageQueue.QueueName 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定識別佇列的易記名稱。
public:
property System::String ^ QueueName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_QueueName")]
public string QueueName { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_QueueName")>]
member this.QueueName : string with get, set
Public Property QueueName As String
屬性值
名稱,識別這個 MessageQueue 所參考的佇列。 這個值不能為 null
。
- 屬性
例外狀況
佇列名稱是 null
。
範例
下列程式代碼範例會取得並設定消息佇列的 QueueName 屬性值。
// Set the queue's QueueName property value.
queue.QueueName = "Example Queue";
// Display the new value of the queue's QueueName property.
Console.WriteLine("MessageQueue.QueueName: {0}", queue.QueueName);
備註
您可以結合 QueueName 與 MachineName ,以建立佇列的易記 Path 名稱。 屬性易記名稱變化的 Path 語法取決於佇列的類型,如下表所示。
佇列類型 | 語法 |
---|---|
公用佇列 | MachineName \QueueName |
私用佇列 | MachineName \Private$ \QueueName |
記錄檔佇列 | MachineName \QueueName \Journal$ |
使用 「.」 代表本機計算機。
變更 QueueName 屬性會影響 Path 屬性。 如果您未設定 QueueName 屬性, MachineName 則 Path 屬性會變成 .\QueueName
。 否則, Path 會 MachineName
\QueueName
變成 。
下表顯示此屬性是否可在各種工作組模式中使用。
工作組模式 | 可用 |
---|---|
本機電腦 | 是 |
本機計算機和直接格式名稱 | 是 |
遠端電腦 | 是 |
遠端電腦和直接格式名稱 | 否 |