UdpClient.DropMulticastGroup Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esce da un gruppo multicast.
Overload
| DropMulticastGroup(IPAddress) |
Esce da un gruppo multicast. |
| DropMulticastGroup(IPAddress, Int32) |
Esce da un gruppo multicast. |
DropMulticastGroup(IPAddress)
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 -> unitPublic Sub DropMulticastGroup (multicastAddr As IPAddress)Parametri
Eccezioni
Oggetto Socket sottostante è stato chiuso.
Si è verificato un errore durante l'accesso al socket.
L'indirizzo IP non è compatibile con il valore AddressFamily che definisce lo schema di indirizzamento del socket.
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
Si applica a
DropMulticastGroup(IPAddress, Int32)
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 -> unitPublic Sub DropMulticastGroup (multicastAddr As IPAddress, ifindex As Integer)Parametri
- ifindex
- Int32
Indirizzo locale del gruppo multicast da cui uscire.
Eccezioni
Oggetto Socket sottostante è stato chiuso.
Si è verificato un errore durante l'accesso al socket.
L'indirizzo IP non è compatibile con il valore AddressFamily che definisce lo schema di indirizzamento del socket.
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.