MessageQueue.Label Свойство

Определение

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

System.Messaging

Сборка:

System.Messaging.dll

Получает или задает описание очереди.

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };

[System.Messaging.MessagingDescription("MQ_Label")]
public string Label { get; set; }

[<System.Messaging.MessagingDescription("MQ_Label")>]
member this.Label : string with get, set

Public Property Label As String

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

String

Метка очереди сообщения. Значение по умолчанию — пустая строка ("").

Атрибуты

MessagingDescriptionAttribute

Исключения

ArgumentException

Для метки задано недопустимое значение.

MessageQueueException

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

Примеры

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

// Set the queue's Label property value.
queue.Label = "Example Queue";

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

Комментарии

Максимальная длина метки очереди сообщений составляет 124 символа.

Свойство Label не обязательно должно быть уникальным во всех очередях. Однако, если несколько очередей совместно используют один и тот же Label, вы не сможете Send(Object) использовать метод для широковещательной передачи сообщения всем из них. Если при отправке сообщения для свойства используется синтаксис Path метки, будет создано исключение, если Label не является уникальным.

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

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

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

• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()