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 を使用) は、キューにアクセスする前に、 を関連付けられた FormatName に変換Pathします。 アプリケーションがオフラインで動作している場合は、書式名の構文を使用する必要があります。それ以外の場合、プライマリ ドメイン コントローラーはパス変換を実行できません。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接の形式名	はい
リモート コンピューター	はい
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• Path
• Label
• MessageQueue