次の方法で共有


UdpClient.SendAsync メソッド

定義

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<TResult> が返されます。

例外

dgramnullです。

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

UdpClient が閉じています。

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

注釈

このオーバーロードは、 メソッドで確立されたリモート ホストにデータグラムを 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<TResult>非同期送信操作を表す 。 Result プロパティの値には、送信されたバイト数が含まれます。

例外

UdpClient が閉じています。

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

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

適用対象

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<TResult> が返されます。

例外

dgramnullです。

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

UdpClient は閉じています。

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

注釈

このメソッドは、指定したエンドポイントにデータグラムを送信します。 このオーバーロードを呼び出す前に、まず、データグラムを配信するリモート ホストの IP アドレスとポート番号を使用して を作成 IPEndPoint する必要があります。 の プロパティIPEndPointに を指定SocketOptionName.BroadcastAddressすることで、データグラムを既定のブロードキャスト アドレス 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<TResult>非同期送信操作を表す 。 Result プロパティの値には、送信されたバイト数が含まれます。

例外

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

UdpClient が閉じています。

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

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

適用対象

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<TResult> が返されます。

例外

dgramnullです。

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

UdpClient が閉じています。

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

注釈

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

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

警告

メソッドを使用してリモート ホストを既に確立している場合は、このメソッドにホスト名またはポート番号を 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<TResult>非同期送信操作を表す 。 Result プロパティの値には、送信されたバイト数が含まれます。

例外

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

UdpClient が閉じています。

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

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

適用対象