MessageQueue.FormatName プロパティ
キューの作成時にメッセージ キューが生成した一意なキュー名を取得します。
Public ReadOnly Property FormatName As String
[C#]
public string FormatName {get;}
[C++]
public: __property String* get_FormatName();
[JScript]
public function get FormatName() : String;
プロパティ値
ネットワークで一意なキューの名前。
例外
例外の種類 | 条件 |
---|---|
MessageQueueException | Path が設定されていません。
または メッセージ キューの API にアクセスしたときにエラーが発生しました。 |
解説
キューの書式名を格納する FormatName プロパティ。メッセージ キューは書式名を使用して、開くキューとキューへのアクセス方法を識別します。その他のほとんどのキューの特性とは異なり、書式名はメッセージ キュー アプリケーション キュー プロパティではありません。そのため、メッセージ キュー管理ツールではアクセスできません。書式名は単にキューの一意な名前です。キューを作成するときにメッセージ キューが生成するか、後でアプリケーションが生成します。
キューからの読み取りまたはキューへの書き込みを実行するときに、パスの指定に書式名構文ではなく、パス名構文 (myComputer\myQueue
など) を使用する場合、 Path は、キューにアクセスする前に、(Active Directory を使用する) プライマリ ドメイン コントローラによって、このパスと関連付けられた FormatName に変換されます。アプリケーションをオフラインで実行する場合は、パスの変換を実行するプライマリ ドメイン コントローラが利用できないため、書式名構文を使用する必要があります。
このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。
ワークグループ モード | 使用可否 |
---|---|
ローカル コンピュータ | はい |
ローカル コンピュータ + 直接書式名 | はい |
リモート コンピュータ | はい |
リモート コンピュータ + 直接書式名 | はい |
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
MessageQueue クラス | MessageQueue メンバ | System.Messaging 名前空間 | Path | Label | MessageQueue