UdpClient.DropMulticastGroup Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Laat een multicastgroep achter.
Overloads
| Name | Description |
|---|---|
| DropMulticastGroup(IPAddress) |
Laat een multicastgroep achter. |
| DropMulticastGroup(IPAddress, Int32) |
Laat een multicastgroep achter. |
DropMulticastGroup(IPAddress)
Laat een multicastgroep achter.
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)Parameters
Uitzonderingen
De onderliggende Socket waarde is gesloten.
Er is een fout opgetreden bij het openen van de socket.
Het IP-adres is niet compatibel met de AddressFamily waarde die het adresseringsschema van de socket definieert.
multicastAddr is null.
Voorbeelden
In het volgende voorbeeld ziet u hoe u een multicastgroep kunt verwijderen door een multicast-adres op te geven.
// 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)
Opmerkingen
De DropMulticastGroup methode trekt de UdpClient uit de multicast-groep die is geïdentificeerd door de opgegeven IPAddress. Nadat de DropMulticastGroup methode is aangeroepen, verzendt de onderliggende Socket gegevens een IGMP-pakket (Internet Group Management Protocol) naar de router, waarbij de router uit de multicast-groep wordt verwijderd. Nadat een UdpClient groep is ingetrokken, kan deze geen datagrammen meer ontvangen die naar die groep worden verzonden.
Note
Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Zodra u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Zie ook
Van toepassing op
DropMulticastGroup(IPAddress, Int32)
Laat een multicastgroep achter.
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)Parameters
- ifindex
- Int32
Het lokale adres van de multicastgroep die moet worden verlaten.
Uitzonderingen
De onderliggende Socket waarde is gesloten.
Er is een fout opgetreden bij het openen van de socket.
Het IP-adres is niet compatibel met de AddressFamily waarde die het adresseringsschema van de socket definieert.
multicastAddr is null.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een multicast-groep kunt verwijderen door een multicast-adres op te geven.
// 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)
Opmerkingen
De DropMulticastGroup methode trekt de UdpClient uit de multicast-groep die is geïdentificeerd door de opgegeven IPAddress. Nadat de DropMulticastGroup methode is aangeroepen, verzendt de onderliggende Socket gegevens een IGMP-pakket (Internet Group Management Protocol) naar de router, waarbij de router uit de multicast-groep wordt verwijderd. Nadat een UdpClient groep is ingetrokken, kan deze geen datagrammen meer ontvangen die naar die groep worden verzonden.
Note
Als u een SocketExceptionontvangt, gebruikt u de SocketException.ErrorCode eigenschap om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.