Прочитать на английском

Поделиться через


MessageQueue.FormatName Свойство

Определение

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

[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }

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

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

Атрибуты

Исключения

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 перед доступом к очереди. Если приложение работает в автономном режиме, необходимо использовать синтаксис имени формата; В противном случае основной контроллер домена не будет доступен для выполнения преобразования пути.

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

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

Применяется к

Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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