UdpClient.DropMulticastGroup Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verlässt eine Multicastgruppe.
Überlädt
DropMulticastGroup(IPAddress) |
Verlässt eine Multicastgruppe. |
DropMulticastGroup(IPAddress, Int32) |
Verlässt eine Multicastgruppe. |
DropMulticastGroup(IPAddress)
Verlässt eine Multicastgruppe.
public:
void DropMulticastGroup(System::Net::IPAddress ^ multicastAddr);
public void DropMulticastGroup (System.Net.IPAddress multicastAddr);
member this.DropMulticastGroup : System.Net.IPAddress -> unit
Public Sub DropMulticastGroup (multicastAddr As IPAddress)
Parameter
Ausnahmen
Der zugrunde liegende Socket wurde geschlossen.
Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.
Die IP-Adresse ist nicht mit dem AddressFamily-Wert kompatibel, der das Adressierungsschema des Sockets definiert.
multicastAddr
ist null
.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie eine Multicast-Gruppe ablegen, indem Sie eine Multicastadresse bereitstellen.
// 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("\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)
Hinweise
Die DropMulticastGroup Methode zieht die UdpClient von der angegebenen Multicastgruppe identifizierte IPAddressMulticast-Gruppe zurück. Nach dem Aufrufen der DropMulticastGroup Methode sendet das zugrunde Socket liegende Internet Group Management Protocol (IGMP)-Paket an den Router, indem der Router aus der Multicastgruppe entfernt wird. Nachdem eine UdpClient Gruppe zurückgenommen hat, kann sie keine Datenogramme mehr empfangen, die an diese Gruppe gesendet werden.
Hinweis
Wenn Sie einen SocketException, verwenden SocketException.ErrorCode Sie zum Abrufen des spezifischen Fehlercodes. Nachdem Sie diesen Code abgerufen haben, können Sie auf die Windows Sockets Version 2-API-Fehlercodedokumentation verweisen, um eine detaillierte Beschreibung des Fehlers zu erhalten.
Siehe auch
Gilt für
DropMulticastGroup(IPAddress, Int32)
Verlässt eine Multicastgruppe.
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 -> unit
Public Sub DropMulticastGroup (multicastAddr As IPAddress, ifindex As Integer)
Parameter
- ifindex
- Int32
Die lokale Adresse der zu verlassenden Multicastgruppe.
Ausnahmen
Der zugrunde liegende Socket wurde geschlossen.
Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.
Die IP-Adresse ist nicht mit dem AddressFamily-Wert kompatibel, der das Adressierungsschema des Sockets definiert.
multicastAddr
ist null
.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Multicast-Gruppe ablegen, indem Sie eine Multicastadresse bereitstellen.
// 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("\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)
Hinweise
Die DropMulticastGroup Methode zieht die UdpClient von der angegebenen Multicastgruppe identifizierte IPAddressMulticast-Gruppe zurück. Nach dem Aufrufen der DropMulticastGroup Methode sendet das zugrunde Socket liegende Internet Group Management Protocol (IGMP)-Paket an den Router, indem der Router aus der Multicastgruppe entfernt wird. Nachdem eine UdpClient Gruppe zurückgenommen hat, kann sie keine Datenogramme mehr empfangen, die an diese Gruppe gesendet werden.
Hinweis
Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code abgerufen haben, können Sie auf die Dokumentation zur Windows Sockets Version 2-API-Fehlercode verweisen, um eine detaillierte Beschreibung des Fehlers zu erhalten.