UdpClient クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

UdpClient クラス

ユーザーデータグラムプロトコル (UDP) ネットワークサービスを提供します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class UdpClient
    Implements IDisposable

Visual Basic (使用法)

Dim instance As UdpClient

public class UdpClient : IDisposable

C++

public ref class UdpClient : IDisposable

public class UdpClient implements IDisposable

JScript

public class UdpClient implements IDisposable

解説

UdpClient クラスは、同期ブロッキングモードのときにコネクションレスの UDP データグラムを送受信するための単純なメソッドを提供します。UDP はコネクションレスのトランスポートプロトコルであるため、データを送受信する前にリモートホスト接続を確立する必要はありません。ただし、オプションとして次の 2 つのいずれかの方法で既定のリモートホストを設定できます。

リモートホスト名とポート番号をパラメータとして使用して UdpClient クラスのインスタンスを作成します。
UdpClient クラスのインスタンスを作成し、Connect メソッドを呼び出します。

UdpClient が用意している送信メソッドのうちの任意のメソッドを使用して、リモートデバイスにデータを送信できます。Receive メソッドを使用して、リモートホストからデータを受信します。

メモ
既定のリモートホストが既に指定されている場合は、ホスト名または IPEndPoint を使用して Send を呼び出すことはできません。この呼び出しを行った場合は、UdpClient が例外をスローします。

また、UdpClient メソッドを使用すると、マルチキャストデータグラムを送受信することもできます。JoinMulticastGroup メソッドを使用して、UdpClient がマルチキャストグループをサブスクライブするようにします。DropMulticastGroup メソッドは、マルチキャストグループから UdpClient をアンサブスクライブするときに使用します。

使用例

ポート 11000 上のホスト名 www.contoso.com を使用して UdpClient 接続を確立する例を次に示します。2 つの別個のリモートホストコンピュータに小さな文字列メッセージが送信されます。Receive メソッドはメッセージを受信するまで実行をブロックします。Receive に渡された IPEndPoint を使用して、応答するホストの ID が明らかになります。

Visual Basic

   ' This constructor arbitrarily assigns the local port number.
   Dim udpClient As New
 UdpClient(11000)
   Try
      udpClient.Connect("www.contoso.com", 11000)
      
      ' Sends a message to the host to which you have connected.
      Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is
 anybody there?")
      
      udpClient.Send(sendBytes, sendBytes.Length)
      
      ' Sends message to a different host using optional hostname and
 port parameters.
      Dim udpClientB As New
 UdpClient()
      udpClientB.Send(sendBytes, sendBytes.Length, "AlternateHostMachineName",
 11000)
      
      ' IPEndPoint object will allow us to read datagrams sent from
 any source.
      Dim RemoteIpEndPoint As New
 IPEndPoint(IPAddress.Any, 0)
      
      ' UdpClient.Receive blocks until a message is received from a
 remote host.
      Dim receiveBytes As [Byte]() = udpClient.Receive(RemoteIpEndPoint)
      Dim returnData As String
 = Encoding.ASCII.GetString(receiveBytes)
      
      ' Which one of these two hosts responded?
      Console.WriteLine(("This is the message you received "
 + _
                                    returnData.ToString()))
       Console.WriteLine(("This message was sent from "
 + _
                                    RemoteIpEndPoint.Address.ToString() + _ 
                                    " on their port number "
 + _
                                    RemoteIpEndPoint.Port.ToString()))
      udpClient.Close()
      udpClientB.Close()
 
   Catch e As Exception
      Console.WriteLine(e.ToString())
   End Try
End Sub

// This constructor arbitrarily assigns the local port number.
UdpClient udpClient = new UdpClient(11000);
    try{
         udpClient.Connect("www.contoso.com", 11000);

         // Sends a message to the host to which you have connected.
         Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
      
         udpClient.Send(sendBytes, sendBytes.Length);

         // Sends a message to a different host using optional hostname
 and port parameters.
         UdpClient udpClientB = new UdpClient();
         udpClientB.Send(sendBytes, sendBytes.Length, "AlternateHostMachineName",
 11000);

         //IPEndPoint object will allow us to read datagrams sent from
 any source.
         IPEndPoint RemoteIpEndPoint = new IPEndPoint(IPAddress.Any,
 0);

         // Blocks until a message returns on this socket from a remote
 host.
         Byte[] receiveBytes = udpClient.Receive(ref RemoteIpEndPoint); 
         string returnData = Encoding.ASCII.GetString(receiveBytes);
   
         // Uses the IPEndPoint object to determine which of these two
 hosts responded.
         Console.WriteLine("This is the message you received " +
                                      returnData.ToString());
         Console.WriteLine("This message was sent from " +
                                     RemoteIpEndPoint.Address.ToString() +
                                     " on their port number " +
                                     RemoteIpEndPoint.Port.ToString());

          udpClient.Close();
          udpClientB.Close();
          
          }  
       catch (Exception e ) {
                  Console.WriteLine(e.ToString());
        }

C++

// With this constructor the local port number is arbitrarily assigned.
UdpClient^ udpClient = gcnew UdpClient;
try
{
   udpClient->Connect( "host.contoso.com", 11000 );

   // Send message to the host to which you have connected.
   array<Byte>^sendBytes = Encoding::ASCII->GetBytes( "Is anybody there?"
 );
   udpClient->Send( sendBytes, sendBytes->Length );

   // Send message to a different host using optional hostname and port
 parameters.
   UdpClient^ udpClientB = gcnew UdpClient;
   udpClientB->Send( sendBytes, sendBytes->Length, "AlternateHostMachineName",
 11000 );

   //IPEndPoint object will allow us to read datagrams sent from any
 source.
   IPEndPoint^ RemoteIpEndPoint = gcnew IPEndPoint( IPAddress::Any,0 );

   // Block until a message returns on this socket from a remote host.
   array<Byte>^receiveBytes = udpClient->Receive( RemoteIpEndPoint );
   String^ returnData = Encoding::ASCII->GetString( receiveBytes );

   // Use the IPEndPoint object to determine which of these two hosts
 responded.
   Console::WriteLine( String::Concat( "This is the message you received ",
 returnData->ToString() ) );
   Console::WriteLine( String::Concat( "This message was sent from ", RemoteIpEndPoint->Address->ToString(),
 " on their port number ", RemoteIpEndPoint->Port.ToString() ) );
   udpClient->Close();
   udpClientB->Close();
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

// This constructor arbitrarily assigns the local port number.
UdpClient udpClient = new UdpClient();
try {
    udpClient.Connect("www.contoso.com", 11000);

    // Sends a message to the host to which you have connected.
    ubyte sendBytes[] = 
        Encoding.get_ASCII().GetBytes("Is anybody there?");
    udpClient.Send(sendBytes, sendBytes.length);

    // Sends a message to a different host using 
    // optional hostname and port parameters.
    UdpClient udpClientB = new UdpClient();
    udpClientB.Send(sendBytes, sendBytes.length, 
        "AlternateHostMachineName", 11000);

    // IPEndPoint object will allow us to read 
    // datagrams sent from any source.
    IPEndPoint remoteIpEndPoint = new IPEndPoint(IPAddress.Any,
 0);

    // Blocks until a message returns on this socket
    // from a remote host.
    ubyte receiveBytes[] = udpClient.Receive(remoteIpEndPoint);
    String returnData = Encoding.get_ASCII().GetString(receiveBytes);

    // Uses the IPEndPoint object to determine which of 
    // these two hosts responded.
    Console.WriteLine(("This is the message you received "
        + returnData.ToString()));
    Console.WriteLine(("This message was sent from " 
        + remoteIpEndPoint.get_Address().ToString() 
        + " on their port number " 
        + System.Convert.ToString(remoteIpEndPoint.get_Port())));
    udpClient.Close();
    udpClientB.Close();
}
catch (System.Exception e) {
    Console.WriteLine(e.ToString());
}

.NET Framework のセキュリティ

SocketPermission 送信接続を確立するか、受信要求を受け入れるための SocketPermission。

継承階層

System.Object
System.Net.Sockets.UdpClient

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
UdpClient メンバ
System.Net.Sockets 名前空間
TcpClient クラス
その他の技術情報
TCP/UDP

>> 「UdpClient クラス」を含む用語の索引
UdpClient クラスのページへのリンク

UdpClient クラスとは？わかりやすく解説

UdpClient クラス

「UdpClient クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

UdpClient クラスとは？ わかりやすく解説

UdpClient クラス

「UdpClient クラス」の関連用語

UdpClient クラスとは？わかりやすく解説