UdpClient.SendAsync メソッド

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

戻り値

Task<TResult> が返されます。

例外

注釈

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

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

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

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

戻り値

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

例外

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

戻り値

Task<TResult> が返されます。

例外

注釈

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

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

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

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

戻り値

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

例外

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

戻り値

Task<TResult> が返されます。

例外

注釈

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

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

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

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

戻り値

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

例外