UdpClient.DropMulticastGroup Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Esce da un gruppo multicast.

Overload

DropMulticastGroup(IPAddress)	Esce da un gruppo multicast.
DropMulticastGroup(IPAddress, Int32)	Esce da un gruppo multicast.

DropMulticastGroup(IPAddress)

Origine:

UDPClient.cs

Esce da un gruppo 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)

Parametri

multicastAddr

IPAddress

Oggetto IPAddress del gruppo multicast da cui uscire.

Eccezioni

ObjectDisposedException

Oggetto Socket sottostante è stato chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

ArgumentException

L'indirizzo IP non è compatibile con il valore AddressFamily che definisce lo schema di indirizzamento del socket.

ArgumentNullException

multicastAddr è null.

Esempio

Nell'esempio seguente viene illustrato come eliminare un gruppo multicast fornendo un indirizzo 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)

Commenti

Il DropMulticastGroup metodo ritira l'oggetto UdpClient dal gruppo multicast identificato dall'oggetto specificato IPAddress. Dopo aver chiamato il metodo, il DropMulticastGroup sottostante Socket invia un pacchetto IGMP (Internet Group Management Protocol) al router, rimuovendo il router dal gruppo multicast. Dopo un UdpClient ritiro dal gruppo, non sarà più in grado di ricevere i datagrammi inviati a tale gruppo.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Vedi anche

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

Origine:

UDPClient.cs

Esce da un gruppo 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)

Parametri

multicastAddr

IPAddress

Oggetto IPAddress del gruppo multicast da cui uscire.

ifindex

Int32

Indirizzo locale del gruppo multicast da cui uscire.

Eccezioni

ObjectDisposedException

Oggetto Socket sottostante è stato chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

ArgumentException

L'indirizzo IP non è compatibile con il valore AddressFamily che definisce lo schema di indirizzamento del socket.

ArgumentNullException

multicastAddr è null.

Esempio

Nell'esempio di codice seguente viene illustrato come eliminare un gruppo multicast fornendo un indirizzo 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)

Commenti

Il DropMulticastGroup metodo ritira l'oggetto UdpClient dal gruppo multicast identificato dall'oggetto specificato IPAddress. Dopo aver chiamato il metodo, il DropMulticastGroup sottostante Socket invia un pacchetto IGMP (Internet Group Management Protocol) al router, rimuovendo il router dal gruppo multicast. Dopo un UdpClient ritiro dal gruppo, non sarà più in grado di ricevere i datagrammi inviati a tale gruppo.

Nota

Se si riceve un SocketExceptionoggetto , utilizzare la proprietà per ottenere il SocketException.ErrorCode codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Vedi anche

• JoinMulticastGroup(IPAddress)