MessageQueue.FormatName Свойство

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Возвращает уникальное имя очереди, созданное во время создания очереди.

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

Значение свойства

String

Имя очереди, уникальной в сети.

Атрибуты

MessagingDescriptionAttribute

Исключения

MessageQueueException

Значение Path не задано.

–или–

Произошла ошибка при доступе к методу очереди сообщений.

Примеры

В следующем примере кода отображается значение свойства очереди FormatName сообщений.

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

Комментарии

Свойство FormatName содержит имя формата очереди. Очередь сообщений использует имя формата, чтобы определить, какая очередь открывается и как получить к ней доступ. В отличие от большинства характеристик очереди, имя формата не является свойством очереди приложений очереди сообщений, поэтому вы не сможете получить доступ к нему с помощью средства управления очередью сообщений. Имя формата — это просто уникальное имя очереди, которое создает очередь сообщений при создании очереди или создании очереди приложения позже.

Если указать путь с помощью синтаксиса имени пути (например myComputer\myQueue) вместо использования синтаксиса имени формата при чтении или записи в очередь, основной контроллер домена (который использует Active Directory) преобразует Path его в связанный FormatName перед доступом к очереди. Если приложение работает в автономном режиме, необходимо использовать синтаксис имени формата; В противном случае основной контроллер домена не будет доступен для перевода пути.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.

Режим рабочей группы	В наличии
Локальный компьютер	Да
Имя локального компьютера и прямого формата	Да
Удаленный компьютер	Да
Имя удаленного компьютера и прямого формата	Да

См. также раздел

• Path
• Label
• MessageQueue