Sdílet prostřednictvím

MessageQueue.FormatName Vlastnost

  • Reference

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

Hodnota Path není nastavená.

-nebo-

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

Příklady

Následující příklad kódu zobrazuje 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í získat přístup. 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 získat přístup 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 při vytváření fronty nebo který aplikace vygeneruje později.

Pokud při čtení nebo zápisu do fronty zadáte cestu pomocí syntaxe názvu cesty (například myComputer\myQueue) namísto použití syntaxe názvu formátu, 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; v opačném případě 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č Yes
Název místního počítače a přímého formátu Yes
Vzdálený počítač Yes
Název vzdáleného počítače a přímého formátu Yes

Platí pro

Viz také