Udostępnij za pośrednictwem


MessageQueue.FormatName Właściwość

Definicja

Pobiera unikatową nazwę kolejki, która jest generowana przez kolejkę w momencie tworzenia kolejki.

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

Wartość właściwości

Nazwa kolejki, która jest unikatowa w sieci.

Atrybuty

Wyjątki

Element Path nie jest ustawiony.

-lub-

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu wyświetla wartość właściwości kolejki komunikatów FormatName .

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

Uwagi

Właściwość FormatName zawiera nazwę formatu kolejki. Kolejkowanie komunikatów używa nazwy formatu do identyfikowania kolejki do otwarcia i sposobu uzyskiwania do niej dostępu. W przeciwieństwie do większości cech kolejki nazwa formatu nie jest właściwością kolejki aplikacji kolejkowania komunikatów, więc nie można uzyskać do niej dostępu za pośrednictwem narzędzia do zarządzania kolejkami komunikatów. Nazwa formatu jest po prostu unikatową nazwą kolejki, która jest generowana podczas tworzenia kolejki lub generowania przez aplikację później.

Jeśli określisz ścieżkę przy użyciu składni nazwy ścieżki (takiej jak myComputer\myQueue) zamiast używać składni nazwy formatu podczas odczytu lub zapisu w kolejce, podstawowy kontroler domeny (który używa usługi Active Directory) tłumaczy element Path na skojarzony FormatName przed uzyskaniem dostępu do kolejki. Jeśli aplikacja działa w trybie offline, musisz użyć składni nazwy formatu; W przeciwnym razie podstawowy kontroler domeny nie będzie dostępny do wykonania translacji ścieżki.

W poniższej tabeli przedstawiono, czy ta właściwość jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej Dostępne
Komputer lokalny Tak
Nazwa komputera lokalnego i bezpośredniego formatu Tak
Komputer zdalny Tak
Nazwa komputera zdalnego i bezpośredniego formatu Tak

Dotyczy

Zobacz też