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