次の方法で共有


MessageQueue.MachineName プロパティ

定義

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

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

プロパティ値

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

属性

例外

MachineNamenull です。 - または -

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

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

次のコード例では、メッセージ キュー 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 と から構築されます QueueNamePath を変更すると (たとえば、書式名の構文を使用する場合)、 プロパティと QueueName プロパティがMachineNameリセットされ、新しいキューが参照されます。 プロパティがQueueName空の場合、 Path は指定したコンピューターのジャーナル キューに設定されます。

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

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

適用対象

こちらもご覧ください