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 して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

こちらもご覧ください

• 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 使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

こちらもご覧ください

• JoinMulticastGroup(IPAddress)