MessageQueue.FormatName 属性

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

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

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

属性值

String

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

属性

MessagingDescriptionAttribute

例外

MessageQueueException

未设置 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 。 如果应用程序脱机工作，则必须使用格式名称语法;否则，主域控制器将无法执行路径转换。

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

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

另请参阅

• Path
• Label
• MessageQueue