UdpClient.DropMulticastGroup Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Pozostawia grupę multiemisji.

Przeciążenia

DropMulticastGroup(IPAddress)	Pozostawia grupę multiemisji.
DropMulticastGroup(IPAddress, Int32)	Pozostawia grupę multiemisji.

DropMulticastGroup(IPAddress)

Źródło:

UDPClient.cs

Pozostawia grupę multiemisji.

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)

Parametry

multicastAddr

IPAddress

Grupa IPAddress multiemisji do opuszczenia.

Wyjątki

ObjectDisposedException

Bazowy Socket został zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

ArgumentException

Adres IP nie jest zgodny z wartością AddressFamily definiującą schemat adresowania gniazda.

ArgumentNullException

multicastAddr to null.

Przykłady

W poniższym przykładzie pokazano, jak usunąć grupę multiemisji, podając adres multiemisji.

// 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)

Uwagi

Metoda DropMulticastGroup wycofuje element UdpClient z grupy multiemisji zidentyfikowanej przez określony IPAddresselement . Po wywołaniu metody bazowa DropMulticastGroupSocket wysyła pakiet IGMP (Internet Group Management Protocol) do routera, usuwając router z grupy multiemisji. Po wycofaniu UdpClient się z grupy nie będzie już można odbierać datagramów wysyłanych do tej grupy.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

Źródło:

UDPClient.cs

Pozostawia grupę multiemisji.

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)

Parametry

multicastAddr

IPAddress

Grupa IPAddress multiemisji do opuszczenia.

ifindex

Int32

Adres lokalny grupy multiemisji do opuszczenia.

Wyjątki

ObjectDisposedException

Bazowy Socket został zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

ArgumentException

Adres IP nie jest zgodny z wartością AddressFamily definiującą schemat adresowania gniazda.

ArgumentNullException

multicastAddr to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak usunąć grupę multiemisji, podając adres multiemisji.

// 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)

Uwagi

Metoda DropMulticastGroup wycofuje element UdpClient z grupy multiemisji zidentyfikowanej przez określony IPAddresselement . Po wywołaniu metody bazowa DropMulticastGroupSocket wysyła pakiet IGMP (Internet Group Management Protocol) do routera, usuwając router z grupy multiemisji. Po wycofaniu UdpClient się z grupy nie będzie już można odbierać datagramów wysyłanych do tej grupy.

Uwaga

Jeśli zostanie wyświetlony element SocketException, użyj SocketException.ErrorCode właściwości , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

• JoinMulticastGroup(IPAddress)