MessageQueue.MachineName プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

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

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

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_MachineName")>]
member this.MachineName : string with get, set

Public Property MachineName As String

プロパティ値

String

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

属性

BrowsableAttribute MessagingDescriptionAttribute

例外

ArgumentException

MachineName が null です。 - または -

コンピューター名が無効です。構文が間違っているためと考えられます。

MessageQueueException

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例では、メッセージ キュー 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);

注釈

MachineNameは、キュー Pathのフレンドリ名構文の不可欠なコンポーネントです。 次の表は、フレンドリ名を使用してキュー パスを識別する場合に、指定した型のキューに使用する必要がある構文を示しています。

[キューの種類]	構文
パブリック キュー	MachineName\QueueName
専用キュー	MachineName\Private$\QueueName
ジャーナル キュー	MachineName\QueueName\Journal$
マシン ジャーナル キュー	MachineName\Journal$
マシンの配信不能キュー	MachineName\Deadletter$
マシン トランザクション配信不能キュー	MachineName\XactDeadletter$

を指定するときは、ローカル コンピューターに "." を使用します MachineName。 このプロパティでは、コンピューター名のみが認識されます (例: Server0)。 プロパティは MachineName IP アドレス形式をサポートしていません。

の観点MachineNameから をPath定義すると、ドメイン コントローラーがパス変換に必要であるため、オフラインで作業するときにアプリケーションは例外をスローします。 したがって、オフラインで作業する場合は、 構文に をPath使用FormatNameする必要があります。

、MachineNamePath、および QueueName の各プロパティは関連しています。 プロパティを MachineName 変更すると、 プロパティが Path 変更されます。 これは、新しい MachineName と から構築されます QueueName。 Path を変更すると (たとえば、書式名の構文を使用する場合)、 プロパティと QueueName プロパティがMachineNameリセットされ、新しいキューが参照されます。 プロパティがQueueName空の場合、 Path は指定したコンピューターのジャーナル キューに設定されます。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接の形式名	はい
リモート コンピューター	はい
リモート コンピューターと直接形式の名前	いいえ

こちらもご覧ください

• QueueName
• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()