UdpClient.DropMulticastGroup Метод

Определение

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

System.Net.Sockets

Сборки:

netstandard.dll, 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(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(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)