MessageQueue.QueueName 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得或設定識別佇列的易記名稱。

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

屬性值

String

名稱，識別這個 MessageQueue 所參考的佇列。 這個值不能為 null。

屬性

BrowsableAttribute MessagingDescriptionAttribute

例外狀況

ArgumentException

佇列名稱是 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變成 。

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

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

另請參閱

• Path
• MachineName