MessageQueue.MachineName Özellik

Başvuru

Tanım

Ad Alanı:: System.Messaging

Bütünleştirilmiş Kod:: System.Messaging.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Şunlara uygulanır

Aracılığıyla paylaş