MessageQueue.FormatName Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Získá jedinečný název fronty, který služba Řízení front zpráv vygenerovala v době vytvoření fronty.

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

Hodnota vlastnosti

String

Název fronty, která je v síti jedinečná.

Atributy

MessagingDescriptionAttribute

Výjimky

MessageQueueException

Není Path nastavená.

nebo

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu zobrazí hodnotu vlastnosti fronty FormatName zpráv.

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

Poznámky

Vlastnost FormatName obsahuje název formátu fronty. Služba Řízení front zpráv používá název formátu k identifikaci fronty, která se má otevřít a jak k ní přistupovat. Na rozdíl od většiny vlastností fronty není název formátu vlastnost fronty aplikace Řízení front zpráv, takže k ní nemůžete přistupovat prostřednictvím nástroje pro správu služby Řízení front zpráv. Název formátu je jednoduše jedinečný název fronty, který služba Řízení front zpráv vygeneruje, když vytvoří frontu nebo kterou aplikace vygeneruje později.

Pokud zadáte cestu pomocí syntaxe názvu cesty (například myComputer\myQueue) místo použití syntaxe názvu formátu při čtení nebo zápisu do fronty, primární řadič domény (který používá Službu Active Directory) před přístupem k frontě přeloží Path na přidružený FormatName . Pokud vaše aplikace pracuje offline, musíte použít syntaxi názvu formátu; jinak nebude primární řadič domény k dispozici k provedení překladu cesty.

Následující tabulka ukazuje, zda je tato vlastnost k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	K dispozici
Místní počítač	Ano
Název místního počítače a přímého formátu	Ano
Vzdálený počítač	Ano
Název vzdáleného počítače a přímého formátu	Ano

Viz také

• Path
• Label
• MessageQueue