UdpClient.DropMulticastGroup メソッド (IPAddress)
マルチキャスト グループへの参加を取り消します。
Overloads Public Sub DropMulticastGroup( _
ByVal multicastAddr As IPAddress _)
[C#]
public void DropMulticastGroup(IPAddressmulticastAddr);
[C++]
public: void DropMulticastGroup(IPAddress* multicastAddr);
[JScript]
public function DropMulticastGroup(
multicastAddr : IPAddress);
パラメータ
- multicastAddr
参加を取り消すマルチキャスト グループの IPAddress 。
例外
| 例外の種類 | 条件 |
|---|---|
| ObjectDisposedException | 基になる Socket は閉じられています。 |
| SocketException | ソケットへのアクセス中にエラーが発生しました。詳細については、「解説」を参照してください。 |
| ArgumentException | この IP アドレスは、ソケットのアドレッシング スキームを定義する AddressFamily 値と互換性がありません。 |
| ArgumentNullException | multicastAddr が null 参照 (Visual Basic では Nothing) です。 |
解説
DropMulticastGroup メソッドは、指定した IPAddress で識別されたマルチキャスト グループから UdpClient を削除します。 DropMulticastGroup メソッドの呼び出し後、基になる Socket がインターネット グループ管理プロトコル (IGMP) パケットをルータに送信し、マルチキャスト グループからそのルータを削除します。グループから削除された UdpClient は、今後そのグループに送信されたデータグラムを受信できません。
メモ SocketException が発生した場合は、 SocketException.ErrorCode を使用して具体的なエラー コードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラー コードのマニュアルから、エラーの詳細情報を確認できます。これは MSDN から入手できます。
使用例
[Visual Basic, C#, C++] マルチキャスト アドレスを提供することによりマルチキャスト グループへの参加を取り消す方法を次の例に示します。
' Send data to ClientTarget.
Console.WriteLine(ControlChars.Lf + "The ClientOriginator sent:" + ControlChars.Lf)
Send.OriginatorSendData(clientOriginator, m_ClientTargetdest)
' Receive data from ClientTarget
Ret = Receive.ReceiveUntilStop(clientOriginator)
' Stop the ClientTarget thread
m_t.Abort()
' Abandon the multicast group.
clientOriginator.DropMulticastGroup(m_GrpAddr)
[C#]
// Send data to ClientTarget.
Console.WriteLine("\nThe ClientOriginator sent:\n");
Send.OriginatorSendData(clientOriginator, m_ClientTargetdest);
// Receive data from ClientTarget
Ret = Receive.ReceiveUntilStop(clientOriginator);
// Stop the ClientTarget thread
m_t.Abort();
// Abandon the multicast group.
clientOriginator.DropMulticastGroup(m_GrpAddr);
[C++]
// Send data to ClientTarget.
Console::WriteLine(S"\nThe ClientOriginator sent:\n");
Send::OriginatorSendData(clientOriginator, m_ClientTargetdest);
// Receive data from ClientTarget
Ret = Receive::ReceiveUntilStop(clientOriginator);
// Stop the ClientTarget thread
m_t->Abort();
// Abandon the multicast group.
clientOriginator->DropMulticastGroup(m_GrpAddr);
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
UdpClient クラス | UdpClient メンバ | System.Net.Sockets 名前空間 | UdpClient.DropMulticastGroup オーバーロードの一覧 | JoinMulticastGroup