UdpClient.DropMulticastGroup Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Quitte un groupe multicast.
Surcharges
| DropMulticastGroup(IPAddress) |
Quitte un groupe multicast. |
| DropMulticastGroup(IPAddress, Int32) |
Quitte un groupe multicast. |
DropMulticastGroup(IPAddress)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Quitte un groupe multicast.
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)Paramètres
Exceptions
Le Socket sous-jacent a été fermé.
Une erreur s’est produite pendant l’accès au socket.
L'adresse IP n'est pas compatible avec la valeur de AddressFamily qui définit le schéma d'adressage du socket.
multicastAddr a la valeur null.
Exemples
L’exemple suivant montre comment supprimer un groupe de multidiffusion en fournissant une adresse de multidiffusion.
// 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)
Remarques
La DropMulticastGroup méthode retire le UdpClient du groupe de multidiffusion identifié par le spécifié IPAddress. Après avoir appelé la DropMulticastGroup méthode, le sous-jacent Socket envoie un paquet IGMP (Internet Group Management Protocol) au routeur, en supprimant le routeur du groupe de multidiffusion. Une fois qu’un UdpClient se retire du groupe, il ne peut plus recevoir de datagrammes envoyés à ce groupe.
Notes
Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous reporter à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Voir aussi
S’applique à
DropMulticastGroup(IPAddress, Int32)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Quitte un groupe multicast.
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)Paramètres
- ifindex
- Int32
Adresse locale du groupe multicast à quitter.
Exceptions
Le Socket sous-jacent a été fermé.
Une erreur s’est produite pendant l’accès au socket.
L'adresse IP n'est pas compatible avec la valeur de AddressFamily qui définit le schéma d'adressage du socket.
multicastAddr a la valeur null.
Exemples
L’exemple de code suivant montre comment supprimer un groupe de multidiffusion en fournissant une adresse de multidiffusion.
// 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)
Remarques
La DropMulticastGroup méthode retire le UdpClient du groupe de multidiffusion identifié par le spécifié IPAddress. Après avoir appelé la DropMulticastGroup méthode, le sous-jacent Socket envoie un paquet IGMP (Internet Group Management Protocol) au routeur, en supprimant le routeur du groupe de multidiffusion. Une fois qu’un UdpClient se retire du groupe, il ne peut plus recevoir de datagrammes envoyés à ce groupe.
Notes
Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous reporter à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
