Partager via


UdpClient.DropMulticastGroup Méthode

Définition

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 -> unit
Public Sub DropMulticastGroup (multicastAddr As IPAddress)

Paramètres

multicastAddr
IPAddress

IPAddress 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 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 -> unit
Public Sub DropMulticastGroup (multicastAddr As IPAddress, ifindex As Integer)

Paramètres

multicastAddr
IPAddress

IPAddress du groupe multicast à quitter.

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.

Voir aussi

S’applique à