UdpClient.DropMulticastGroup 方法

  • 參考

定義

命名空間:
System.Net.Sockets
組件:
System.Net.Sockets.dll
組件:
System.dll
組件:
netstandard.dll

保留多點傳送 (Multicast) 群組。

多載

DropMulticastGroup(IPAddress)

保留多點傳送 (Multicast) 群組。
DropMulticastGroup(IPAddress, Int32)

保留多點傳送 (Multicast) 群組。

DropMulticastGroup(IPAddress)

保留多點傳送 (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)

參數

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 來取得特定的錯誤碼。 取得此程式碼之後，您可以參閱Windows Sockets 第 2 版 API 錯誤碼檔，以取得錯誤的詳細描述。

另請參閱

適用於

DropMulticastGroup(IPAddress, Int32)

保留多點傳送 (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)

參數

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 屬性來取得特定的錯誤碼。 取得此程式碼之後，您可以參考Windows 通訊端第 2 版 API 錯誤碼檔，以取得錯誤的詳細描述。

另請參閱

適用於