UdpClient.DropMulticastGroup 方法

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

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

多載

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

DropMulticastGroup(IPAddress)

來源:

UDPClient.cs

保留多點傳送 (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 錯誤碼 檔，以取得錯誤的詳細描述。

另請參閱

• JoinMulticastGroup(IPAddress)

DropMulticastGroup(IPAddress, Int32)

來源:

UDPClient.cs

保留多點傳送 (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 Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。

另請參閱

• JoinMulticastGroup(IPAddress)