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()