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


MessageQueue.FormatName Свойство

Определение

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

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

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

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

Атрибуты

Исключения

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

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

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

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

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