UdpClient.DropMulticastGroup Метод

Определение

Пространство имен:

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

Покидает группу многоадресной рассылки.

Перегрузки

DropMulticastGroup(IPAddress)	Покидает группу многоадресной рассылки.
DropMulticastGroup(IPAddress, Int32)	Покидает группу многоадресной рассылки.

DropMulticastGroup(IPAddress)

Исходный код:

UDPClient.cs

Покидает группу многоадресной рассылки.

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)

Параметры

multicastAddr

IPAddress

Удаляемый объект IPAddress группы многоадресной рассылки.

Исключения

ObjectDisposedException

Основной объект Socket закрыт.

SocketException

Произошла ошибка при обращении к сокету.

ArgumentException

IP-адрес несовместим со значением AddressFamily, которое определяет схему адресации сокета.

ArgumentNullException

multicastAddr имеет значение null.

Примеры

В следующем примере показано, как удалить группу многоадресной рассылки, указав адрес многоадресной рассылки.

// 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)

Комментарии

Метод DropMulticastGroup удаляет UdpClient из группы многоадресной рассылки, определяемой указанным IPAddressобъектом . После вызова DropMulticastGroup метода базовый Socket объект отправляет пакет IGMP на маршрутизатор, удаляя маршрутизатор из группы многоадресной рассылки. После выхода из UdpClient группы он больше не сможет получать датаграммы, отправленные в нее.

Примечание

Если вы получаете SocketException, используйте SocketException.ErrorCode для получения определенного кода ошибки. Получив этот код, вы можете обратиться к документации по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

См. также раздел

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

Исходный код:

UDPClient.cs

Покидает группу многоадресной рассылки.

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)

Параметры

multicastAddr

IPAddress

Удаляемый объект IPAddress группы многоадресной рассылки.

ifindex

Int32

Локальный адрес удаляемой группы многоадресной рассылки.

Исключения

ObjectDisposedException

Основной объект Socket закрыт.

SocketException

Произошла ошибка при обращении к сокету.

ArgumentException

IP-адрес несовместим со значением AddressFamily, которое определяет схему адресации сокета.

ArgumentNullException

multicastAddr имеет значение null.

Примеры

В следующем примере кода показано, как удалить группу многоадресной рассылки, указав адрес многоадресной рассылки.

// 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)

Комментарии

Метод DropMulticastGroup удаляет UdpClient из группы многоадресной рассылки, определяемой указанным IPAddressобъектом . После вызова DropMulticastGroup метода базовый Socket объект отправляет пакет IGMP на маршрутизатор, удаляя маршрутизатор из группы многоадресной рассылки. После выхода из UdpClient группы он больше не сможет получать датаграммы, отправленные в нее.

Примечание

Если вы получаете SocketException, используйте SocketException.ErrorCode свойство , чтобы получить конкретный код ошибки. Получив этот код, вы можете обратиться к документации по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

См. также раздел

• JoinMulticastGroup(IPAddress)