MessageQueue.MachineName プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MessageQueue.MachineName プロパティ

メッセージキューのキューが存在するコンピュータの名前を取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property MachineName As
 String

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As String

value = instance.MachineName

instance.MachineName = value

public string MachineName { get;
 set; }

C++

public:
property String^ MachineName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_MachineName ()

/** @property */
public void set_MachineName (String value)

JScript

public function get MachineName
 () : String

public function set MachineName
 (value : String)

プロパティ値
キューが存在するコンピュータの名前。メッセージキューの既定値は、ローカルコンピュータを表す "." です。

例外

例外の種類	条件
ArgumentException	MachineName が null 参照 (Visual Basic では Nothing) です。
ArgumentException	コンピュータ名が無効です。構文が誤っている可能性があります。
MessageQueueException	メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

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 は指定したコンピュータの履歴キューに設定されます。

このプロパティが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	○
ローカルコンピュータと直接書式名	○
リモートコンピュータ	○
リモートコンピュータと直接書式名	×

使用例

メッセージキューの MachineName プロパティに対し、値の取得と設定を行うコード例を次に示します。

// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";

// Display the new value of the queue's MachineName property.
Console.WriteLine("MessageQueue.MachineName: {0}", queue.MachineName);

// Set the queue's MachineName property value to the name of the local
// computer.
queue.set_MachineName(".");
// Display the new value of the queue's MachineName property.
Console.WriteLine("MessageQueue.MachineName: {0}", 
    queue.get_MachineName());