MessageQueue.QueueName 属性

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

获取或设置标识队列的友好名称。

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

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_QueueName")]
public string QueueName { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_QueueName")>]
member this.QueueName : string with get, set

Public Property QueueName As String

属性值

String

名称，该名称标识由此 MessageQueue 引用的队列。 该值不能为 null。

属性

BrowsableAttribute MessagingDescriptionAttribute

例外

ArgumentException

队列名称为 null。

示例

下面的代码示例获取并设置消息队列的 QueueName 属性的值。

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

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

注解

可以将 与 组合QueueNameMachineName在一起，为队列创建友好Path名称。 属性的友好名称变体的 Path 语法取决于队列的类型，如下表所示。

队列类型	语法
公共队列	MachineName\QueueName
专用队列	MachineName\Private$\QueueName
日志队列	MachineName\QueueName\Journal$

使用“.”表示本地计算机。

更改 QueueName 属性会影响 Path 属性。 如果在未设置 属性的情况下设置 QueueNameMachineName ，则 Path 属性将变为 .\QueueName。 否则， Path 变为 MachineName\QueueName。

下表显示了此属性在各种工作组模式下是否可用。

工作组模式	可用
本地计算机	是
本地计算机和直接格式名称	是
远程计算机	是
远程计算机和直接格式名称	否

另请参阅

• Path
• MachineName