UdpClient.DropMulticastGroup Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Deixa um grupo multicast.
Sobrecargas
| Name | Description |
|---|---|
| DropMulticastGroup(IPAddress) |
Deixa um grupo multicast. |
| DropMulticastGroup(IPAddress, Int32) |
Deixa um grupo multicast. |
DropMulticastGroup(IPAddress)
Deixa um grupo 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 subjacente Socket foi encerrado.
Ocorreu um erro ao aceder ao soquete.
O endereço IP não é compatível com o AddressFamily valor que define o esquema de endereçamento do soquete.
multicastAddr é null.
Exemplos
O exemplo seguinte demonstra como eliminar 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(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)
Observações
O DropMulticastGroup método retira o UdpClient do grupo multicast identificado pelo especificado IPAddress. Após chamar o DropMulticastGroup método, o subjacente Socket envia um pacote de Protocolo de Gestão de Grupo de Internet (IGMP) para o router, removendo o router do grupo multicast. Após uma UdpClient retirada do grupo, deixará de conseguir receber datagramas enviados para esse grupo.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar a documentação do código de erro da API
Ver também
Aplica-se a
DropMulticastGroup(IPAddress, Int32)
Deixa um grupo 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
A morada local do grupo multicast para sair.
Exceções
O subjacente Socket foi encerrado.
Ocorreu um erro ao aceder ao soquete.
O endereço IP não é compatível com o AddressFamily valor que define o esquema de endereçamento do soquete.
multicastAddr é null.
Exemplos
O exemplo de código seguinte demonstra como eliminar 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(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)
Observações
O DropMulticastGroup método retira o UdpClient do grupo multicast identificado pelo especificado IPAddress. Após chamar o DropMulticastGroup método, o subjacente Socket envia um pacote de Protocolo de Gestão de Grupo de Internet (IGMP) para o router, removendo o router do grupo multicast. Após uma UdpClient retirada do grupo, deixará de conseguir receber datagramas enviados para esse grupo.
Note
Se receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 para uma descrição detalhada do erro.