UdpClient.DropMulticastGroup メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
マルチキャスト グループを残します。
オーバーロード
| 名前 | 説明 |
|---|---|
| DropMulticastGroup(IPAddress) |
マルチキャスト グループを残します。 |
| DropMulticastGroup(IPAddress, Int32) |
マルチキャスト グループを残します。 |
DropMulticastGroup(IPAddress)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
マルチキャスト グループを残します。
public:
void DropMulticastGroup(System::Net::IPAddress ^ multicastAddr);public void DropMulticastGroup(System.Net.IPAddress multicastAddr);member this.DropMulticastGroup : System.Net.IPAddress -> unitPublic Sub DropMulticastGroup (multicastAddr As IPAddress)パラメーター
例外
基になる Socket が閉じられました。
ソケットにアクセスするときにエラーが発生しました。
IP アドレスは、ソケットのアドレス指定スキームを定義する AddressFamily 値と互換性がありません。
multicastAddr は nullです。
例
次の例では、マルチキャスト アドレスを指定してマルチキャスト グループを削除する方法を示します。
// 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);
' 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)
注釈
DropMulticastGroupメソッドは、指定したUdpClientによって識別されたマルチキャスト グループからIPAddressを取り消します。 DropMulticastGroupメソッドを呼び出した後、基になるSocketは、インターネット グループ管理プロトコル (IGMP) パケットをルーターに送信し、マルチキャスト グループからルーターを削除します。 UdpClientがグループから取り消されると、そのグループに送信されたデータグラムを受信できなくなります。
Note
SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
こちらもご覧ください
適用対象
DropMulticastGroup(IPAddress, Int32)
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
- ソース:
- UDPClient.cs
マルチキャスト グループを残します。
public:
void DropMulticastGroup(System::Net::IPAddress ^ multicastAddr, int ifindex);public void DropMulticastGroup(System.Net.IPAddress multicastAddr, int ifindex);member this.DropMulticastGroup : System.Net.IPAddress * int -> unitPublic Sub DropMulticastGroup (multicastAddr As IPAddress, ifindex As Integer)パラメーター
- ifindex
- Int32
残すマルチキャスト グループのローカル アドレス。
例外
基になる Socket が閉じられました。
ソケットにアクセスするときにエラーが発生しました。
IP アドレスは、ソケットのアドレス指定スキームを定義する AddressFamily 値と互換性がありません。
multicastAddr は nullです。
例
次のコード例は、マルチキャスト アドレスを指定してマルチキャスト グループを削除する方法を示しています。
// 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);
' 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)
注釈
DropMulticastGroupメソッドは、指定したUdpClientによって識別されたマルチキャスト グループからIPAddressを取り消します。 DropMulticastGroupメソッドを呼び出した後、基になるSocketは、インターネット グループ管理プロトコル (IGMP) パケットをルーターに送信し、マルチキャスト グループからルーターを削除します。 UdpClientがグループから取り消されると、そのグループに送信されたデータグラムを受信できなくなります。
Note
SocketExceptionを受け取った場合は、SocketException.ErrorCode プロパティを使用して特定のエラー コードを取得します。 このコードを取得した後、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
