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