UdpClient.DropMulticastGroup メソッド

  • リファレンス

定義

名前空間:
System.Net.Sockets
アセンブリ:
System.Net.Sockets.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

マルチキャスト グループへの参加を取り消します。

オーバーロード

DropMulticastGroup(IPAddress)

マルチキャスト グループへの参加を取り消します。
DropMulticastGroup(IPAddress, Int32)

マルチキャスト グループへの参加を取り消します。

DropMulticastGroup(IPAddress)

マルチキャスト グループへの参加を取り消します。

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)

マルチキャスト グループへの参加を取り消します。

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 のエラー コードドキュメントを参照してください。

こちらもご覧ください

適用対象