Compartilhar via


UdpClient.DropMulticastGroup Método

Definição

Deixa um grupo multicast.

Sobrecargas

Nome Description
DropMulticastGroup(IPAddress)

Deixa um grupo multicast.

DropMulticastGroup(IPAddress, Int32)

Deixa um grupo multicast.

DropMulticastGroup(IPAddress)

Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs

Deixa um grupo 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 grupo multicast a ser deixado.

Exceções

O subjacente Socket foi fechado.

Erro ao acessar o 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 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(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 grupo multicast identificado pelo especificado IPAddress. Depois de chamar o DropMulticastGroup método, o subjacente Socket envia um pacote IGMP (Internet Group Management Protocol) para o roteador, removendo o roteador do grupo multicast. Após uma UdpClient retirada do grupo, ele não poderá mais receber datagramas enviados para 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ê 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

Aplica-se a

DropMulticastGroup(IPAddress, Int32)

Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs

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 -> unit
Public Sub DropMulticastGroup (multicastAddr As IPAddress, ifindex As Integer)

Parâmetros

multicastAddr
IPAddress

O IPAddress grupo multicast a ser deixado.

ifindex
Int32

O endereço local do grupo multicast a ser deixado.

Exceções

O subjacente Socket foi fechado.

Erro ao acessar o 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 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(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 grupo multicast identificado pelo especificado IPAddress. Depois de chamar o DropMulticastGroup método, o subjacente Socket envia um pacote IGMP (Internet Group Management Protocol) para o roteador, removendo o roteador do grupo multicast. Após uma UdpClient retirada do grupo, ele não poderá mais receber datagramas enviados para 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

Aplica-se a