MessageQueue.FormatName Tulajdonság

Definíció

Névtér:
System.Messaging
Szerelvény:
System.Messaging.dll

Lekéri a Message Queuing által az üzenetsor létrehozásakor létrehozott egyedi üzenetsornevet.

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

Tulajdonság értéke

String

Az üzenetsor neve, amely a hálózaton egyedi.

Attribútumok
MessagingDescriptionAttribute

Kivételek

MessageQueueException

A Path beállítás nincs beállítva.

-vagy-

Hiba történt a Message Queuing metódus elérésekor.

Példák

Az alábbi példakód egy üzenetsor tulajdonságának értékét jeleníti meg FormatName .

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

Megjegyzések

A FormatName tulajdonság tartalmazza az üzenetsor formátumnevét. A Message Queuing formátumnévvel azonosítja, hogy melyik üzenetsort kell megnyitni, és hogyan érheti el. Az üzenetsorok jellemzőitől eltérően a formátumnév nem a Message Queuing alkalmazás üzenetsor-tulajdonsága, így nem férhet hozzá a Message Queuing felügyeleti eszközén keresztül. A formátumnév egyszerűen az üzenetsor egyedi neve, amelyet a Message Queuing az üzenetsor létrehozásakor vagy az alkalmazás későbbi létrehozásakor hoz létre.

Ha az elérési utat az elérési útnév szintaxisa (például myComputer\myQueue) használatával adja meg, és nem a formátumnév szintaxisát használja az üzenetsorba való íráskor, az elsődleges tartományvezérlő (amely Active Directory használ) a Path a társított FormatName-ra fordítja le az üzenetsor elérése előtt. Ha az alkalmazás offline állapotban működik, a formátumnév szintaxisát kell használnia; ellenkező esetben az elsődleges tartományvezérlő nem lesz elérhető az elérési út fordításához.

Az alábbi táblázat azt mutatja be, hogy ez a tulajdonság elérhető-e különböző munkacsoport-módban.

Munkacsoport mód Elérhető
Helyi számítógép Igen
Helyi számítógép és közvetlen formátum neve Igen
Távoli számítógép Igen
Távoli számítógép és közvetlen formátum neve Igen

A következőre érvényes:

Lásd még