MessageQueue.MulticastAddress プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

MSMQ 3.0 で導入されました。 キューに関連付けられているマルチキャスト アドレスを取得または設定します。

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

[System.Messaging.MessagingDescription("MQ_MulticastAddress")]
public string MulticastAddress { get; set; }

[<System.Messaging.MessagingDescription("MQ_MulticastAddress")>]
member this.MulticastAddress : string with get, set

Public Property MulticastAddress As String

プロパティ値

String

有効なマルチキャスト アドレス (次に示す形式) を格納している String、またはキューがマルチキャスト アドレスに関連付けられていないことを示す null。

<address>:<port>

属性

MessagingDescriptionAttribute

例外

PlatformNotSupportedException

MSMQ 3.0 がインストールされていません。

注釈

プロパティは MulticastAddress 、非トランザクション キューを、メッセージの送信時に使用できるマルチキャスト アドレスに関連付けるために使用されます。 トランザクション キューをマルチキャスト アドレスに関連付けることはできません。 送信側アプリケーションがマルチキャスト アドレスにメッセージを送信すると、メッセージ キューはそのアドレスに関連付けられているすべてのキューにメッセージのコピーを送信します。

IP マルチキャスト アドレスは、224.0.0.0 から 239.255.255.255 までのクラス D の範囲である必要があります。これは、最初の 4 つの上位ビットを 1110 に設定する場合に対応します。 ただし、この範囲のアドレスの特定の範囲のみが予約されておらず、マルチキャスト メッセージの送信に使用できます。 予約済みマルチキャスト アドレスの最新の一覧については、 インターネット割り当て番号機関 (IANA) のインターネット マルチキャスト アドレス Web ページを参照してください。 ポート番号に制限はありません。

複数のソース コンピューターがマルチキャスト メッセージを送信していて、特定のキューで 1 台のソース コンピューターからのメッセージのみを受信する場合、各ソース コンピューターは IP アドレスとポート番号の異なる組み合わせにメッセージを送信する必要があります。

マルチキャスト アドレスからキューの関連付けを解除するには、 プロパティを MulticastAddress 長さ 0 の文字列に設定します。 を に null設定しないでください。これにより、 が発生するためです ArgumentNullException。

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

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