MessageQueue.FormatName 属性

定义

获取“消息队列”在创建队列时生成的唯一队列名。

public:
 property System::String ^ FormatName { System::String ^ get(); };
[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }
[<System.Messaging.MessagingDescription("MQ_FormatName")>]
member this.FormatName : string
Public ReadOnly Property FormatName As String

属性值

队列的名称,该名称在网络上是唯一的。

属性

例外

未设置 Path

- 或 -

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

示例

下面的代码示例显示消息队列的 FormatName 属性的值。

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

注解

属性 FormatName 包含队列的格式名称。 消息队列使用格式名称来标识要打开的队列以及如何访问它。 与队列的大多数特征不同,格式名称不是消息队列应用程序队列属性,因此无法通过消息队列管理工具访问它。 格式名称只是队列的唯一名称,消息队列在创建队列时生成,或者应用程序稍后会生成该名称。

如果使用路径名称语法 ((如 myComputer\myQueue) )指定路径,而不是在读取或写入队列时使用格式名称语法,则使用 Active Directory) 的主域控制器 (在访问队列之前将 转换为 Path 关联的 FormatName 。 如果应用程序脱机工作,则必须使用格式名称语法;否则,主域控制器将无法执行路径转换。

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

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

适用于

另请参阅