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 содержит имя формата очереди. Очередь сообщений использует имя формата, чтобы определить, какую очередь следует открыть и как к ней получить доступ. В отличие от большинства характеристик очереди, имя формата не является свойством очереди приложения Message Queuing, поэтому вы не можете получить к нему доступ с помощью средства управления очередью сообщений. Имя формата — это просто уникальное имя очереди, которое создается очередью сообщений при создании очереди или которое приложение создает позже.

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

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

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

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

• Path
• Label
• MessageQueue