MessageQueue.MulticastAddress プロパティ

.NET Framework クラス ライブラリ リファレンス

MessageQueue.MulticastAddress プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property MulticastAddress As
 String

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As String

value = instance.MulticastAddress

instance.MulticastAddress = value

C#

public string MulticastAddress { get;
 set; }

C++

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

J#

/** @property */
public String get_MulticastAddress ()

/** @property */
public void set_MulticastAddress (String value)

JScript

public function get MulticastAddress
 () : String

public function set MulticastAddress
 (value : String)

プロパティ値
有効なマルチキャスト アドレス (次に示す形式) を格納している String、またはキューがマルチキャスト アドレスに関連付けられていないことを示す null 参照 (Visual Basic では Nothing)。

<address>:<port>

例外

例外の種類	条件
PlatformNotSupportedException	MSMQ 3.0 がインストールされていません。

解説

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

IP マルチキャスト アドレスは、224.0.0.0 ～ 239.255.255.255 の範囲のクラス D に属している必要があり、これは先頭の 4 つの上位ビットが 1110 に相当する設定に対応しています。ただし、まだ予約されておらず、マルチキャスト メッセージの送信に使用できるのは、この範囲内の一部の範囲のアドレスだけです。予約済みのマルチキャスト アドレスの最新の一覧については、「Internet Assigned Number Authority (IANA) Internet Multicast Addresses」ページを参照してください。ポート番号には制限がありません。

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

マルチキャスト アドレスに対するキューの関連付けを解除するには、MulticastAddress プロパティに長さ 0 の文字列を設定します。null 参照 (Visual Basic では Nothing) は設定しないでください。これを設定すると、ArgumentNullException が発生します。

このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	○
ローカル コンピュータと直接書式名	○
リモート コンピュータ	×
リモート コンピュータと直接書式名	×

.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

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間