UdpClient.DropMulticastGroup Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Verlässt eine Multicastgruppe.

Überlädt

DropMulticastGroup(IPAddress)	Verlässt eine Multicastgruppe.
DropMulticastGroup(IPAddress, Int32)	Verlässt eine Multicastgruppe.

DropMulticastGroup(IPAddress)

Quelle:

UDPClient.cs

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

multicastAddr

IPAddress

Die IPAddress der zu verlassenden Multicastgruppe.

Ausnahmen

ObjectDisposedException

Der zugrunde liegende Socket wurde geschlossen.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

ArgumentException

Die IP-Adresse ist nicht mit dem AddressFamily-Wert kompatibel, der das Adressierungsschema des Sockets definiert.

ArgumentNullException

multicastAddr ist null.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie eine Multicastgruppe löschen, indem Sie eine Multicastadresse angeben.

// 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 aus der Multicastgruppe zurück, die durch den angegebenen IPAddressidentifiziert wird. Nach dem Aufrufen der DropMulticastGroup -Methode sendet die zugrunde liegende Socket Datei ein IGMP-Paket (Internet Group Management Protocol) an den Router und entfernt den Router aus der Multicastgruppe. Nachdem eine UdpClient Gruppe sich aus der Gruppe zurückgezogen hat, kann sie keine An diese Gruppe gesendeten Datagramme mehr empfangen.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Weitere Informationen

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

Quelle:

UDPClient.cs

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

multicastAddr

IPAddress

Die IPAddress der zu verlassenden Multicastgruppe.

ifindex

Int32

Die lokale Adresse der zu verlassenden Multicastgruppe.

Ausnahmen

ObjectDisposedException

Der zugrunde liegende Socket wurde geschlossen.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

ArgumentException

Die IP-Adresse ist nicht mit dem AddressFamily-Wert kompatibel, der das Adressierungsschema des Sockets definiert.

ArgumentNullException

multicastAddr ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie eine Multicastgruppe löschen, indem Sie eine Multicastadresse angeben.

// 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 aus der Multicastgruppe zurück, die durch den angegebenen IPAddressidentifiziert wird. Nach dem Aufrufen der DropMulticastGroup -Methode sendet die zugrunde liegende Socket Datei ein IGMP-Paket (Internet Group Management Protocol) an den Router und entfernt den Router aus der Multicastgruppe. Nachdem eine UdpClient Gruppe sich aus der Gruppe zurückgezogen hat, kann sie keine An diese Gruppe gesendeten Datagramme mehr empfangen.

Hinweis

Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Weitere Informationen

• JoinMulticastGroup(IPAddress)