UdpClient.SendAsync メソッド

リファレンス

定義

名前空間:: System.Net.Sockets

アセンブリ:: System.Net.Sockets.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

SendAsync(Byte[], Int32)	UDP データグラムをリモートホストに非同期的に送信します。
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	UDP データグラムをリモートホストに非同期的に送信します。
SendAsync(Byte[], Int32, IPEndPoint)	UDP データグラムをリモートホストに非同期的に送信します。
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)	UDP データグラムをリモートホストに非同期的に送信します。
SendAsync(Byte[], Int32, String, Int32)	UDP データグラムをリモートホストに非同期的に送信します。
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)	UDP データグラムをリモートホストに非同期的に送信します。

SendAsync(Byte[], Int32)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

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

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes);

member this.SendAsync : byte[] * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer) As Task(Of Integer)

パラメーター

datagram: Byte[]

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

bytes: Int32

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

戻り値

Task<Int32>

Task<TResult> が返されます。

例外

ArgumentNullException

dgram が nullです。

InvalidOperationException

UdpClient が既定のリモートホストを既に確立しました。

ObjectDisposedException

UdpClient が閉じています。

SocketException

ソケットへのアクセス中にエラーが発生しました。

注釈

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

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

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの ArgumentException使用例外は、引き続き同期的にスローされます。格納されている例外については、によって Send(Byte[], Int32)スローされる例外に関するページを参照してください。

適用対象

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

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

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

パラメーター

datagram: ReadOnlyMemory<Byte>

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

cancellationToken: CancellationToken

キャンセル要求を監視するためのトークン。既定値は None です。

戻り値

ValueTask<Int32>

ValueTask<TResult>非同期送信操作を表す。 Result プロパティの値には、送信されたバイト数が含まれます。

例外

ObjectDisposedException

UdpClient が閉じています。

SocketException

ソケットへのアクセス中にエラーが発生しました。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

適用対象

SendAsync(Byte[], Int32, IPEndPoint)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

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

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::Net::IPEndPoint ^ endPoint);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint? endPoint);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint endPoint);

member this.SendAsync : byte[] * int * System.Net.IPEndPoint -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Task(Of Integer)

パラメーター

datagram: Byte[]

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

bytes: Int32

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

endPoint: IPEndPoint

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

戻り値

Task<Int32>

Task<TResult> が返されます。

例外

ArgumentNullException

dgram が nullです。

InvalidOperationException

UdpClient が既定のリモートホストを既に確立しました。

ObjectDisposedException

UdpClient は閉じています。

SocketException

ソケットへのアクセス中にエラーが発生しました。

注釈

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

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

警告

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

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの ArgumentException使用例外は、引き続き同期的にスローされます。格納されている例外については、によって Send(Byte[], Int32, IPEndPoint)スローされる例外に関するページを参照してください。

適用対象

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

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

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Net.IPEndPoint? endPoint, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), endPoint As IPEndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

パラメーター

datagram: ReadOnlyMemory<Byte>

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

endPoint: IPEndPoint

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

cancellationToken: CancellationToken

キャンセル要求を監視するためのトークン。既定値は None です。

戻り値

ValueTask<Int32>

ValueTask<TResult>非同期送信操作を表す。 Result プロパティの値には、送信されたバイト数が含まれます。

例外

InvalidOperationException

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

ObjectDisposedException

UdpClient が閉じています。

SocketException

ソケットへのアクセス中にエラーが発生しました。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

適用対象

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

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

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

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::String ^ hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string? hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string hostname, int port);

member this.SendAsync : byte[] * int * string * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, hostname As String, port As Integer) As Task(Of Integer)

パラメーター

datagram: Byte[]

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

bytes: Int32

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

hostname: String

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

port: Int32

通信先のリモートポート番号。

戻り値

Task<Int32>

Task<TResult> が返されます。

例外

ArgumentNullException

dgram が nullです。

InvalidOperationException

UdpClient が既定のリモートホストを既に確立しました。

ObjectDisposedException

UdpClient が閉じています。

SocketException

ソケットへのアクセス中にエラーが発生しました。

注釈

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

警告

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

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの ArgumentException使用例外は、引き続き同期的にスローされます。格納されている例外については、によって Send(Byte[], Int32, String, Int32)スローされる例外に関するページを参照してください。

適用対象

SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

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

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, string? hostname, int port, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), hostname As String, port As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

パラメーター

datagram: ReadOnlyMemory<Byte>

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

hostname: String

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

port: Int32

通信先のリモートポート番号。

cancellationToken: CancellationToken

キャンセル要求を監視するためのトークン。既定値は None です。

戻り値

ValueTask<Int32>

ValueTask<TResult>非同期送信操作を表す。 Result プロパティの値には、送信されたバイト数が含まれます。

例外

InvalidOperationException

UdpClient が既定のリモートホストを既に確立しました。

ObjectDisposedException

UdpClient が閉じています。

SocketException

ソケットへのアクセス中にエラーが発生しました。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

適用対象

次の方法で共有

UdpClient.SendAsync メソッド

定義

オーバーロード

SendAsync(Byte[], Int32)

パラメーター

戻り値

例外

注釈

適用対象

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

パラメーター

戻り値

例外

適用対象

SendAsync(Byte[], Int32, IPEndPoint)

パラメーター

戻り値

例外

注釈

適用対象

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

パラメーター

戻り値

例外

適用対象

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

パラメーター

戻り値

例外

注釈

適用対象

SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)

パラメーター

戻り値

例外

適用対象

その他のリソース