MessageQueue.MachineName プロパティ

.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

C#

public string MachineName { get;
 set; }

C++

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

J#

/** @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 プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// 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());

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
QueueName
Path
MessageQueue.FormatName プロパティ
GetPublicQueues
GetMessageQueueEnumerator