次の方法で共有

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