UdpClient.DropMulticastGroup Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Abandona un grupo de multidifusión.

Sobrecargas

DropMulticastGroup(IPAddress)	Abandona un grupo de multidifusión.
DropMulticastGroup(IPAddress, Int32)	Abandona un grupo de multidifusión.

DropMulticastGroup(IPAddress)

Source:

UDPClient.cs

Abandona un grupo de multidifusión.

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)

Parámetros

multicastAddr

IPAddress

IPAddress del grupo de multidifusión que se va a abandonar.

Excepciones

ObjectDisposedException

El objeto Socket subyacente se ha cerrado.

SocketException

Se produjo un error al acceder al socket.

ArgumentException

La dirección IP no es compatible con el valor de AddressFamily que define el esquema de direcciones del socket.

ArgumentNullException

multicastAddr es null.

Ejemplos

En el ejemplo siguiente se muestra cómo quitar un grupo de multidifusión proporcionando una dirección de multidifusión.

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

Comentarios

El DropMulticastGroup método retira del UdpClient grupo de multidifusión identificado por el especificado IPAddress. Después de llamar al DropMulticastGroup método , el subyacente Socket envía un paquete del Protocolo de administración de grupos de Internet (IGMP) al enrutador, quitando el enrutador del grupo de multidifusión. UdpClient Después de retirarse del grupo, ya no podrá recibir datagramas enviados a ese grupo.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

Source:

UDPClient.cs

Abandona un grupo de multidifusión.

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)

Parámetros

multicastAddr

IPAddress

IPAddress del grupo de multidifusión que se va a abandonar.

ifindex

Int32

La dirección local del grupo de multidifusión que se va a abandonar.

Excepciones

ObjectDisposedException

El objeto Socket subyacente se ha cerrado.

SocketException

Se produjo un error al acceder al socket.

ArgumentException

La dirección IP no es compatible con el valor de AddressFamily que define el esquema de direcciones del socket.

ArgumentNullException

multicastAddr es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo quitar un grupo de multidifusión proporcionando una dirección de multidifusión.

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

Comentarios

El DropMulticastGroup método retira del UdpClient grupo de multidifusión identificado por el especificado IPAddress. Después de llamar al DropMulticastGroup método , el subyacente Socket envía un paquete del Protocolo de administración de grupos de Internet (IGMP) al enrutador, quitando el enrutador del grupo de multidifusión. UdpClient Después de retirarse del grupo, ya no podrá recibir datagramas enviados a ese grupo.

Nota

Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico. Después de obtener este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

• JoinMulticastGroup(IPAddress)