MessageQueue.MachineName 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得或設定訊息佇列位置的電腦名稱。

public:
 property System::String ^ MachineName { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_MachineName")>]
member this.MachineName : string with get, set

Public Property MachineName As String

屬性值

String

佇列位置的電腦名稱。 訊息佇列預設是 "."，也就是本機電腦。

屬性

BrowsableAttribute MessagingDescriptionAttribute

例外狀況

ArgumentException

MachineName 為 null。 -或-

電腦的名稱無效，可能是因為語法不正確。

MessageQueueException

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

範例

下列程式代碼範例會取得並設定消息佇列 MachineName 屬性的值。

// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";

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

備註

MachineName是佇列Path易記名稱語法的一個整數位元件。 下表顯示當您想要使用其易記名稱來識別佇列路徑時，應該用於指定類型的佇列語法。

佇列類型	語法
公用佇列	MachineName\QueueName
私用佇列	MachineName\Private$\QueueName
記錄檔佇列	MachineName\QueueName\Journal$
計算機日誌佇列	MachineName\Journal$
機器寄不出的信件佇列	MachineName\Deadletter$
計算機交易寄不出的信件佇列	MachineName\XactDeadletter$

指定 MachineName時，請使用 “.” 做為本機計算機。 只有電腦名稱可辨識這個屬性，例如 。 Server0 屬性 MachineName 不支援IP位址格式。

如果您根據 MachineName定義 Path ，則應用程式會在離線工作時擲回例外狀況，因為需要域控制器進行路徑轉譯。 因此，在離線工作時，您必須針對 Path 語法使用 FormatName 。

MachineName、 Path和 QueueName 屬性是相關的。 變更 MachineName 屬性會導致 Path 屬性變更。 它會從新的 MachineName 和 QueueName建置。 例如，將 (變更 Path 為使用格式名稱語法，) 重 MachineName 設 和 QueueName 屬性以參考新的佇列。 如果 屬性是空的QueueName，則會Path設定為您所指定計算機的 日誌 佇列。

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

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

另請參閱

• QueueName
• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()