MessageQueue.FormatName プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キューの作成時にメッセージ キューが生成した一意のキュー名を取得します。
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 : stringPublic ReadOnly Property FormatName As Stringプロパティ値
ネットワークで一意なキューの名前。
- 属性
例外
例
次のコード例では、メッセージ キューのプロパティの値を FormatName 表示します。
// Display the value of the queue's FormatName property.
Console.WriteLine("MessageQueue.FormatName: {0}", queue.FormatName);
注釈
この FormatName プロパティには、キューの形式名が含まれています。 メッセージ キューでは、形式名を使用して、開くキューとそのキューにアクセスする方法を識別します。 ほとんどのキューの特性とは異なり、形式名はメッセージ キュー アプリケーション キュー プロパティではありません。そのため、メッセージ キュー管理ツールを使用してアクセスすることはできません。 形式名は単にキューの一意の名前であり、キューの作成時にメッセージ キューが生成するか、アプリケーションが後で生成します。
キューに対する読み取りまたは書き込み時に形式名構文を使用するのではなく、パス名構文 (などmyComputer\myQueue) を使用してパスを指定した場合、プライマリ ドメイン コントローラー (Active Directory を使用) は、キューにアクセスする前に関連付けられているFormatNameドメイン コントローラーに変換Pathします。 アプリケーションがオフラインで動作している場合は、形式名の構文を使用する必要があります。それ以外の場合、プライマリ ドメイン コントローラーはパス変換を実行できません。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
| ワークグループ モード | 利用可能 |
|---|---|
| ローカル コンピューター | はい |
| ローカル コンピューターと直接形式名 | はい |
| リモート コンピューター | はい |
| リモート コンピューターと直接形式名 | はい |