UdpClient.Send メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

netstandard.dll, System.Net.Sockets.dll

UDP データグラムをリモート ホストに送信します。

オーバーロード

名前	説明
Send(Byte[], Int32, String, Int32)	指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。
Send(ReadOnlySpan<Byte>, String, Int32)	指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。
Send(Byte[], Int32, IPEndPoint)	指定したリモート エンドポイントのホストに UDP データグラムを送信します。
Send(Byte[], Int32)	UDP データグラムをリモート ホストに送信します。
Send(ReadOnlySpan<Byte>)	UDP データグラムをリモート ホストに送信します。
Send(ReadOnlySpan<Byte>, IPEndPoint)	指定したリモート エンドポイントのホストに UDP データグラムを送信します。

Send(Byte[], Int32, String, Int32)

ソース:

UDPClient.cs

指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::String ^ hostname, int port);

public int Send(byte[] dgram, int bytes, string? hostname, int port);

member this.Send : byte[] * int * string * int -> int

Public Function Send (dgram As Byte(), bytes As Integer, hostname As String, port As Integer) As Integer

パラメーター

dgram

Byte[]

送信する UDP データグラムを指定する Byte 型の配列。バイト配列として表されます。

bytes

Int32

データグラム内のバイト数。

hostname

String

データグラムを送信するリモート ホストの名前。

port

Int32

通信するリモート ポート番号。

戻り値

Int32

送信されたバイト数。

例外

ArgumentNullException

dgram は nullです。

InvalidOperationException

UdpClientでは、既定のリモート ホストが既に確立されています。

ObjectDisposedException

UdpClient は閉じられます。

SocketException

ソケットにアクセスするときにエラーが発生しました。

例

次の例では、 Send メソッドを示します。 この例では、ホスト名とポート番号を使用してターゲット ホストを識別します。

UdpClient udpClient = new UdpClient();

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

Send メソッドは、hostnameおよびportパラメーターで指定された値にデータグラムを送信し、正常に送信されたバイト数を返します。 hostname パラメーター値に "255.255.255.255" を指定することで、既定のブロードキャスト アドレスにデータグラムを送信できます。

データグラムを他のブロードキャスト アドレスに送信する場合は、 Client メソッドを使用して基になる Socketを取得し、ソケット オプションを SocketOptionName.Broadcast に設定します。 Socket クラスの使用に戻すこともできます。

注

Connect メソッドを使用してリモート ホストを既に確立している場合は、このメソッドにホスト名またはポート番号を指定しないでください。 その場合、 Send メソッドは SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。

こちらもご覧ください

• Broadcast
• Connect(String, Int32)
• Socket

Send(ReadOnlySpan<Byte>, String, Int32)

ソース:

UDPClient.cs

指定したリモート ホスト上の指定されたポートに UDP データグラムを送信します。

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::String ^ hostname, int port);

public int Send(ReadOnlySpan<byte> datagram, string? hostname, int port);

member this.Send : ReadOnlySpan<byte> * string * int -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), hostname As String, port As Integer) As Integer

パラメーター

datagram

ReadOnlySpan<Byte>

送信する UDP データグラムを指定する型ByteのReadOnlySpan<T>。

hostname

String

データグラムを送信するリモート ホストの名前。

port

Int32

通信するリモート ポート番号。

戻り値

Int32

送信されたバイト数。

例外

InvalidOperationException

UdpClientでは、既定のリモート ホストが既に確立されています。

ObjectDisposedException

UdpClient は閉じられます。

SocketException

ソケットにアクセスするときにエラーが発生しました。

Send(Byte[], Int32, IPEndPoint)

ソース:

UDPClient.cs

指定したリモート エンドポイントのホストに UDP データグラムを送信します。

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::Net::IPEndPoint ^ endPoint);

public int Send(byte[] dgram, int bytes, System.Net.IPEndPoint? endPoint);

member this.Send : byte[] * int * System.Net.IPEndPoint -> int

Public Function Send (dgram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Integer

パラメーター

dgram

Byte[]

送信する UDP データグラムを指定する Byte 型の配列。バイトの配列として表されます。

bytes

Int32

データグラム内のバイト数。

endPoint

IPEndPoint

データグラムを送信するホストとポートを表す IPEndPoint 。

戻り値

Int32

送信されたバイト数。

例外

ArgumentNullException

dgram は nullです。

InvalidOperationException

UdpClient は、既定のリモート ホストを既に確立しています。

ObjectDisposedException

UdpClient は閉じています。

SocketException

ソケットにアクセスするときにエラーが発生しました。

例

次の例では、 Send メソッドを示します。 この例では、 IPEndPoint を使用してターゲット ホストを指定します。

UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);	

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
try{
    udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
Try
   udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

Send メソッドは、指定したエンドポイントにデータグラムを送信し、正常に送信されたバイト数を返します。 このオーバーロードを呼び出す前に、まず、データグラムを配信するリモート ホストの IP アドレスとポート番号を使用して、 IPEndPoint を作成する必要があります。 IPEndPointのAddress プロパティにSocketOptionName.Broadcastを指定することで、既定のブロードキャスト アドレス 255.255.255.255 にデータグラムを送信できます。 このIPEndPointを作成したら、endPoint パラメーターとして Send メソッドに渡します。

データグラムを他のブロードキャスト アドレスに送信する場合は、 Client メソッドを使用して基になる Socketを取得し、ソケット オプションを SocketOptionName.Broadcast に設定します。 Socket クラスの使用に戻すこともできます。

注

Connect メソッドを使用してリモート ホストを既に確立している場合は、このメソッドに endPoint パラメーターを指定しないでください。 その場合、 Send メソッドは SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。

こちらもご覧ください

• Broadcast
• Connect(String, Int32)
• Socket
• IPEndPoint

Send(Byte[], Int32)

ソース:

UDPClient.cs

UDP データグラムをリモート ホストに送信します。

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes);

public int Send(byte[] dgram, int bytes);

member this.Send : byte[] * int -> int

Public Function Send (dgram As Byte(), bytes As Integer) As Integer

パラメーター

dgram

Byte[]

送信する UDP データグラムを指定する Byte 型の配列。バイト配列として表されます。

bytes

Int32

データグラム内のバイト数。

戻り値

Int32

送信されたバイト数。

例外

ArgumentNullException

dgram は nullです。

InvalidOperationException

UdpClientでは、既定のリモート ホストが既に確立されています。

ObjectDisposedException

UdpClient は閉じられます。

SocketException

ソケットにアクセスするときにエラーが発生しました。

例

次の例では、 Send メソッドを示します。 このオーバーロードを使用する前に、既定のリモート ホストを確立する必要があります。

UdpClient udpClient = new UdpClient("www.contoso.com", 11000);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

Dim udpClient As New UdpClient("www.contoso.com", 11000)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

このオーバーロードは、 Connect メソッドで確立されたリモート ホストにデータグラムを送信し、送信されたバイト数を返します。 このオーバーロードを呼び出す前に Connect を呼び出さない場合、 Send メソッドは SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。

データグラムを別のリモート ホストに送信する場合は、 Connect メソッドを呼び出し、目的のリモート ホストを指定する必要があります。 ブロードキャスト アドレスにデータグラムを送信するには、他の Send メソッドオーバーロードのいずれかを使用します。

こちらもご覧ください

• Connect(String, Int32)

Send(ReadOnlySpan<Byte>)

ソース:

UDPClient.cs

UDP データグラムをリモート ホストに送信します。

public:
 int Send(ReadOnlySpan<System::Byte> datagram);

public int Send(ReadOnlySpan<byte> datagram);

member this.Send : ReadOnlySpan<byte> -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte)) As Integer

パラメーター

datagram

ReadOnlySpan<Byte>

送信する UDP データグラムを指定する型ByteのReadOnlySpan<T>。

戻り値

Int32

送信されたバイト数。

例外

InvalidOperationException

UdpClientは、既定のリモート ホストを確立していません。

ObjectDisposedException

UdpClient は閉じられます。

SocketException

ソケットにアクセスするときにエラーが発生しました。

Send(ReadOnlySpan<Byte>, IPEndPoint)

ソース:

UDPClient.cs

指定したリモート エンドポイントのホストに UDP データグラムを送信します。

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::Net::IPEndPoint ^ endPoint);

public int Send(ReadOnlySpan<byte> datagram, System.Net.IPEndPoint? endPoint);

member this.Send : ReadOnlySpan<byte> * System.Net.IPEndPoint -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), endPoint As IPEndPoint) As Integer

パラメーター

datagram

ReadOnlySpan<Byte>

送信する UDP データグラムを指定する型ByteのReadOnlySpan<T>。

endPoint

IPEndPoint

データグラムを送信するホストとポートを表す IPEndPoint 。

戻り値

Int32

送信されたバイト数。

例外

InvalidOperationException

UdpClient は既定のリモート ホストを既に確立しており、 endPoint は nullされていません。

ObjectDisposedException

UdpClient は閉じています。

SocketException

ソケットにアクセスするときにエラーが発生しました。