MessageQueue.MachineName プロパティ
メッセージ キューのキューが存在するコンピュータの名前を取得または設定します。
Public Property MachineName As String
[C#]
public string MachineName {get; set;}
[C++]
public: __property String* get_MachineName();public: __property void set_MachineName(String*);
[JScript]
public function get MachineName() : String;public function set MachineName(String);
プロパティ値
キューが存在するコンピュータの名前。メッセージ キューの既定値は、ローカル コンピュータを表す "." です。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentException | MachineName が null 参照 (Visual Basic では Nothing) です。 |
| ArgumentException | コンピュータ名が無効です。構文が誤っている可能性があります。 |
| MessageQueueException | メッセージ キューの API にアクセスしたときにエラーが発生しました。 |
解説
MachineName は、キュー Path の表示名を使用する構文に不可欠なコンポーネントです。キュー パスを表示名を使用して識別するときに、指定した種類のキューに対して使用する構文を次の表に示します。
| キューの種類 | 構文 |
|---|---|
| パブリック キュー | MachineName\ QueueName |
| プライベート キュー | MachineName\ Private$\ QueueName |
| ジャーナル キュー | MachineName\ QueueName\ Journal$ |
| コンピュータの履歴キュー | MachineName\ Journal$ |
| コンピュータ配信不能キュー | MachineName\ Deadletter$ |
| コンピュータ トランザクション配信不能キュー | MachineName\ XactDeadletter$ |
MachineName にローカル コンピュータを指定する場合は "." を使用します。このプロパティではコンピュータ名だけが認識されます。たとえば、 Server0 など。 MachineName プロパティは IP アドレス形式をサポートしません。
Path を MachineName で定義した場合、パス変換にドメイン コントローラが必要なため、アプリケーションをオフラインで実行すると例外がスローされます。そのため、オフラインで作業をする場合は、 Path 構文に FormatName を使用する必要があります。
メモ MachineName 、 Path 、 QueueName の各プロパティは相互に関係します。 MachineName プロパティを変更すると、 Path プロパティが変更されます。これは、新しい MachineName と QueueName から構築されます。 Path を (たとえば、書式名構文を使用するように) 変更すると、新しいキューを参照するように MachineName プロパティと QueueName プロパティがリセットされます。 QueueName プロパティが空の場合、 Path は指定したコンピュータの履歴キューに設定されます。
このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。
| ワークグループ モード | 使用可否 |
|---|---|
| ローカル コンピュータ | はい |
| ローカル コンピュータ + 直接書式名 | はい |
| リモート コンピュータ | はい |
| リモート コンピュータ + 直接書式名 | いいえ |
必要条件
プラットフォーム: 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 名前空間 | QueueName | Path | FormatName | GetMachineId | GetPrivateQueuesByMachine | GetPublicQueuesByMachine | GetPublicQueues | GetMessageQueueEnumerator