MessageQueue.FormatName Ö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'in kuyruğun oluşturulduğu sırada oluşturduğu benzersiz kuyruk adını alır.

public:
 property System::String ^ FormatName { System::String ^ get(); };

[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }

[<System.Messaging.MessagingDescription("MQ_FormatName")>]
member this.FormatName : string

Public ReadOnly Property FormatName As String

Özellik Değeri

String

Ağdaki benzersiz kuyruğun adı.

Öznitelikler: MessagingDescriptionAttribute

Özel durumlar

MessageQueueException

Path ayarlanmadı.

-veya-

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

Örnekler

Aşağıdaki kod örneği, ileti kuyruğunun FormatName özelliğinin değerini görüntüler.

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

Açıklamalar

özelliği kuyruğun FormatName biçim adını içerir. Message Queuing, hangi kuyruğun açılıp nasıl erişilir olduğunu belirlemek için biçim adını kullanır. Bir kuyruğun özelliklerinin çoğundan farklı olarak, biçim adı bir Message Queuing uygulama kuyruğu özelliği olmadığından, Message Queuing yönetim aracı aracılığıyla erişemezsiniz. Biçim adı yalnızca kuyruk için benzersiz bir addır. Message Queuing kuyruğu oluştururken veya uygulamanın daha sonra oluşturduğu sırada oluşturur.

Kuyruğa okurken veya yazarken biçim adı söz dizimini kullanmak yerine yol adı söz dizimini (örneğinmyComputer\myQueue) kullanarak bir yol belirtirseniz, birincil etki alanı denetleyicisi (Active Directory kullanan) kuyruğa erişmeden önce öğesini ilişkiliye FormatName çevirirPath. Uygulamanız çevrimdışı çalışıyorsa, biçim adı söz dizimini kullanmanız gerekir; aksi takdirde, birincil etki alanı denetleyicisi yol çevirisini gerçekleştirmek için kullanılamaz.

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ı	Yes

Şunlara uygulanır