MessageQueue.MachineName 属性

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

获取或设置“消息队列”队列所在的计算机的名称。

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

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

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

Public Property MachineName As String

属性值

String

队列所在的计算机的名称。 “消息队列”默认值为“.”，即本地计算机。

属性

BrowsableAttribute MessagingDescriptionAttribute

例外

ArgumentException

MachineName 为 null。 - 或 -

计算机名称无效，可能是因为语法不正确。

MessageQueueException

访问“消息队列”方法时出错。

示例

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

// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";

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

注解

MachineName是队列 Path的友好名称语法的组成部分。 下表显示了在想要使用队列路径友好名称标识队列路径时，应用于指定类型的队列的语法。

队列类型	语法
公共队列	MachineName\QueueName
专用队列	MachineName\Private$\QueueName
日志队列	MachineName\QueueName\Journal$
计算机日记队列	MachineName\Journal$
计算机死信队列	MachineName\Deadletter$
计算机事务死信队列	MachineName\XactDeadletter$

指定 MachineName时，对本地计算机使用“.”。 仅识别此属性的计算机名称，例如 Server0。 属性 MachineName 不支持 IP 地址格式。

如果在 中MachineName定义 Path ，则应用程序在脱机工作时会引发异常，因为需要域控制器进行路径转换。 因此，脱机工作时，必须使用 FormatName 语法。Path

、 MachineNamePath和 QueueName 属性是相关的。 更改 MachineName 属性会导致 Path 属性发生更改。 它是从新的 MachineName 和 QueueName生成的。 例如，将 Path (更改为使用格式名称语法) 将 和 QueueName 属性重置MachineName为引用新队列。 QueueName如果 属性为空，则将 Path 设置为指定的计算机的日记队列。

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

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

另请参阅

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