共用方式為


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 。 如果您的應用程式離線運作,您必須使用格式名稱語法;否則,主要域控制器將無法執行路徑轉譯。

下表顯示此屬性是否可在各種工作組模式中使用。

工作組模式 可用
本機電腦
本機計算機和直接格式名稱
遠端電腦
遠端電腦和直接格式名稱

適用於

另請參閱