Aracılığıyla paylaş

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

MachineName şeklindedirnull. -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ü Sözdizimi
Genel kuyruk MachineName\QueueName
Özel kuyruk MachineName\Private$\QueueName
Günlük kuyruğu 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. Path değerini değiştirmek (ö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 Günlük 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 Mevcut
Yerel bilgisayar Evet
Yerel bilgisayar ve doğrudan biçim adı Evet
Uzak bilgisayar Evet
Uzak bilgisayar ve doğrudan biçim adı Hayır

Şunlara uygulanır

Ayrıca bkz.