UdpClient.DropMulticastGroup Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- UDPClient.cs
- 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 -> unitPublic Sub DropMulticastGroup (multicastAddr As IPAddress)Parâmetros
Exceções
O Socket subjacente foi fechado.
Ocorreu um erro ao acessar o soquete.
O endereço IP não é compatível com o valor AddressFamily que define o esquema de endereçamento do soquete.
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
Aplica-se a
DropMulticastGroup(IPAddress, Int32)
- Origem:
- UDPClient.cs
- Origem:
- UDPClient.cs
- 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 -> unitPublic Sub DropMulticastGroup (multicastAddr As IPAddress, ifindex As Integer)Parâmetros
- ifindex
- Int32
O endereço local do grupo de multicast do qual sair.
Exceções
O Socket subjacente foi fechado.
Ocorreu um erro ao acessar o soquete.
O endereço IP não é compatível com o valor AddressFamily que define o esquema de endereçamento do soquete.
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.
