通过

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 设置为指定的计算机的日记队列。

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

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

适用于

另请参阅