UdpClient.DropMulticastGroup Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Sai de um grupo de multicast.

Sobrecargas

DropMulticastGroup(IPAddress)	Sai de um grupo de multicast.
DropMulticastGroup(IPAddress, Int32)	Sai de um grupo de multicast.

DropMulticastGroup(IPAddress)

Origem:

UDPClient.cs

Sai de um grupo de 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)

Parâmetros

multicastAddr

IPAddress

O IPAddress do grupo de multicast do qual sair.

Exceções

ObjectDisposedException

O Socket subjacente foi fechado.

SocketException

Ocorreu um erro ao acessar o soquete.

ArgumentException

O endereço IP não é compatível com o valor AddressFamily que define o esquema de endereçamento do soquete.

ArgumentNullException

multicastAddr é null.

Exemplos

O exemplo a seguir demonstra como remover um grupo multicast fornecendo um endereço multicast.

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

Comentários

O DropMulticastGroup método retira o UdpClient do grupo multicast identificado pelo especificado IPAddress. Depois de chamar o DropMulticastGroup método , o subjacente Socket envia um pacote IGMP (Protocolo de Gerenciamento de Grupo da Internet) para o roteador, removendo o roteador do grupo multicast. Depois que um UdpClient for retirado do grupo, ele não poderá mais receber datagramas enviados a esse grupo.

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Confira também

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

Origem:

UDPClient.cs

Sai de um grupo de 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)

Parâmetros

multicastAddr

IPAddress

O IPAddress do grupo de multicast do qual sair.

ifindex

Int32

O endereço local do grupo de multicast do qual sair.

Exceções

ObjectDisposedException

O Socket subjacente foi fechado.

SocketException

Ocorreu um erro ao acessar o soquete.

ArgumentException

O endereço IP não é compatível com o valor AddressFamily que define o esquema de endereçamento do soquete.

ArgumentNullException

multicastAddr é null.

Exemplos

O exemplo de código a seguir demonstra como remover um grupo multicast fornecendo um endereço multicast.

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

Comentários

O DropMulticastGroup método retira o UdpClient do grupo multicast identificado pelo especificado IPAddress. Depois de chamar o DropMulticastGroup método , o subjacente Socket envia um pacote IGMP (Protocolo de Gerenciamento de Grupo da Internet) para o roteador, removendo o roteador do grupo multicast. Depois que um UdpClient for retirado do grupo, ele não poderá mais receber datagramas enviados a esse grupo.

Observação

Se você receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Confira também

• JoinMulticastGroup(IPAddress)