MessageQueue.MachineName Özellik

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Message Queuing kuyruğunun bulunduğu bilgisayarın adını alır veya ayarlar.

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

Özellik Değeri

String

Kuyruğun bulunduğu bilgisayarın adı. Message Queuing varsayılanı yerel bilgisayar olan "." şeklindedir.

Öznitelikler

BrowsableAttribute MessagingDescriptionAttribute

Özel durumlar

ArgumentException

şeklindedir MachineNamenull. -veya-

Söz dizimi yanlış olduğundan bilgisayarın adı geçerli değil.

MessageQueueException

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, ileti kuyruğunun MachineName özelliğinin değerini alır ve ayarlar.

// 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);

Açıklamalar

MachineName, kuyruğunun Pathkolay ad söz diziminin ayrılmaz bir bileşenidir. Aşağıdaki tabloda, kolay adını kullanarak kuyruk yolunu tanımlamak istediğinizde belirtilen türde bir kuyruk için kullanmanız gereken söz dizimi gösterilmektedir.

Kuyruk türü	Syntax
Genel kuyruk	MachineName\QueueName
Özel kuyruk	MachineName\Private$\QueueName
kuyruğu Journal	MachineName\QueueName\Journal$
Makine günlüğü kuyruğu	MachineName\Journal$
Makine teslim edilemeyen ileti kuyruğu	MachineName\Deadletter$
Makine işlemsel teslim edilemeyen ileti kuyruğu	MachineName\XactDeadletter$

belirtirken MachineNameyerel bilgisayar için "." kullanın. Bu özellik için yalnızca bilgisayar adı tanınır, örneğin, Server0. MachineName özelliği IP adresi biçimini desteklemiyor.

olarak MachineNametanımlarsanızPath, etki alanı denetleyicisi yol çevirisi için gerekli olduğundan, uygulama çevrimdışı çalışırken bir özel durum oluşturur. Bu nedenle, çevrimdışı çalışırken söz dizimi için Path komutunu kullanmanız FormatName gerekir.

MachineName, Pathve QueueName özellikleri ilişkilidir. özelliğinin MachineName değiştirilmesi özelliğin Path değişmesine neden olur. Yeni MachineName ve sürümünden QueueNameoluşturulur. değerinin Path değiştirilmesi (örneğin, biçim adı söz dizimini kullanmak için) ve QueueName özelliklerini yeni kuyruğa başvurmak üzere sıfırlarMachineName. QueueName özelliği boşsa, Path belirttiğiniz bilgisayarın Journal kuyruğuna ayarlanır.

Aşağıdaki tabloda bu özelliğin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu	Kullanılabilir
Yerel bilgisayar	Yes
Yerel bilgisayar ve doğrudan biçim adı	Yes
Uzak bilgisayar	Yes
Uzak bilgisayar ve doğrudan biçim adı	No

Ayrıca bkz.

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