次の方法で共有

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

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

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

適用対象

こちらもご覧ください