SslStream.ReadAsync メソッド

定義

名前空間:

System.Net.Security

アセンブリ:

System.Net.Security.dll

オーバーロード

ReadAsync(Memory<Byte>, CancellationToken)	このストリームからデータを非同期的に読み取り、それを指定されたメモリ範囲に格納します。
ReadAsync(Byte[], Int32, Int32, CancellationToken)	このストリームからデータを非同期的に読み取り、それをバイト配列の指定の範囲に格納します。

ReadAsync(Memory<Byte>, CancellationToken)

ソース:

SslStream.cs

このストリームからデータを非同期的に読み取り、それを指定されたメモリ範囲に格納します。

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

パラメーター

buffer

Memory<Byte>

このストリームから読み取ったバイトを受け取るバッファー。

cancellationToken

CancellationToken

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

戻り値

ValueTask<Int32>

非同期の読み取り操作を表すタスク。 その Result プロパティの値には、buffer に読み取られたバイトの合計数が含まれます。 読み取るデータがこれ以上存在しない場合は 0 を返します。

例外

InvalidOperationException

認証が行われていません。

IOException

読み取り操作に失敗しました。 内部例外が存在する場合は、チェックしてエラーの原因を確認してください。

NotSupportedException

既に実行中の読み取り操作が存在します。

ObjectDisposedException

このオブジェクトは閉じられました。

OperationCanceledException

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

注釈

このメソッドは、 で使用できるデータと同じ量のデータを buffer読み取ります。

複数の同時読み取り操作を実行することはできません。

正常に認証されるまで、このメソッドを呼び出すことはできません。

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

ソース:

SslStream.cs

このストリームからデータを非同期的に読み取り、それをバイト配列の指定の範囲に格納します。

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

パラメーター

buffer

Byte[]

このストリームから読み取ったバイトを受け取るバッファー。

offset

Int32

このストリームから読み取ったデータの格納を開始する位置を示す、buffer 内のインデックス番号が 0 から始まる位置。

count

Int32

このストリームから読み取られた最大バイト数。

cancellationToken

CancellationToken

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

戻り値

Task<Int32>

非同期の読み取り操作を表すタスク。 その Result プロパティの値には、buffer に読み取られたバイトの合計数が含まれます。 読み取るデータがこれ以上存在しない場合は 0 を返します。

例外

ArgumentNullException

buffer が nullです。

ArgumentOutOfRangeException

offset が 0 未満です。

または

count が 0 未満です。

または

count が、buffer から offset を引いた長さを超えています。

InvalidOperationException

認証が行われていません。

IOException

読み取り操作に失敗しました。 内部例外が存在する場合は、チェックしてエラーの原因を確認してください。

NotSupportedException

既に実行中の読み取り操作が存在します。

ObjectDisposedException

このオブジェクトは閉じられました。

OperationCanceledException

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

注釈

メソッドは、ストリームから最大countバイト数を読み取り、 でoffset始まるにbuffer格納します。

複数の同時読み取り操作を実行することはできません。

正常に認証されるまで、このメソッドを呼び出すことはできません。

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