次の方法で共有


NetworkStream.WriteAsync メソッド

定義

オーバーロード

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

読み取り専用メモリのバイト メモリ範囲から NetworkStream に、データを非同期操作として書き込みます。

WriteAsync(Byte[], Int32, Int32, CancellationToken)

バイト配列の指定された範囲から NetworkStream に、データを非同期操作として書き込みます。

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

ソース:
NetworkStream.cs
ソース:
NetworkStream.cs
ソース:
NetworkStream.cs

読み取り専用メモリのバイト メモリ範囲から NetworkStream に、データを非同期操作として書き込みます。

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

パラメーター

buffer
ReadOnlyMemory<Byte>

NetworkStream に書き込むデータが含まれるメモリの領域。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。

戻り値

非同期の書き込み操作を表すタスク。

例外

NetworkStream では、書き込みがサポートされません。

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

- または -

ネットワークへの書き込み中にエラーが発生しました。

NetworkStream が閉じています。

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

注釈

このメソッドは、 buffer のすべてのバイトをネットワークに送信します。

注意

プロパティを呼び出CanWriteして、 NetworkStream が書き込み可能かどうかを確認します。 書き込み不可能な に NetworkStream 書き込もうとすると、 が表示 InvalidOperationExceptionされます。

注意

IOException受け取った場合は、 プロパティをInnerExceptionチェックして、 SocketExceptionが原因かどうかを判断します。 その場合は、 プロパティを ErrorCode 使用して特定のエラー コードを取得し、エラーの詳細な説明については、Windows ソケット バージョン 2 API エラー コードのドキュメントを参照してください。

適用対象

WriteAsync(Byte[], Int32, Int32, CancellationToken)

ソース:
NetworkStream.cs
ソース:
NetworkStream.cs
ソース:
NetworkStream.cs

バイト配列の指定された範囲から NetworkStream に、データを非同期操作として書き込みます。

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);
public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);
public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

パラメーター

buffer
Byte[]

NetworkStream に書き込むデータを含むバイト配列。

offset
Int32

データの書き込みを開始する buffer 内の場所。

sizecount
Int32

NetworkStream に書き込むバイト数。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。

戻り値

非同期の書き込み操作を表すタスク。

例外

buffer パラメーターが null です。

offset パラメーターが 0 未満です。

- または -

offset パラメーターが buffer の長さを超えています。

- または -

size パラメーターが 0 未満です。

- または -

size パラメーターが、buffer パラメーターの値を引いた offset の長さを超えています。

NetworkStream では、書き込みがサポートされません。

ネットワークへの書き込み中にエラーが発生しました。

- または -

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

NetworkStream が閉じています。

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

注釈

このメソッドは、指定された offset から始まり、 のbuffer内容からネットワークにバイトを送信sizeします。

注意

プロパティを呼び出CanWriteして、 NetworkStream が書き込み可能かどうかを確認します。 書き込み不可能な に NetworkStream 書き込もうとすると、 が表示 InvalidOperationExceptionされます。

注意

IOException受け取った場合は、 プロパティをInnerExceptionチェックして、 SocketExceptionが原因かどうかを判断します。 その場合は、 プロパティを ErrorCode 使用して特定のエラー コードを取得し、エラーの詳細な説明については、Windows ソケット バージョン 2 API エラー コードのドキュメントを参照してください。

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

適用対象