SslStream.ReadAsync 方法

参考

定义

命名空间:: System.Net.Security

程序集:: System.Net.Security.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

ReadAsync(Memory<Byte>, CancellationToken)	从此流中异步读取数据，并将其存储在指定的内存范围内。
ReadAsync(Byte[], Int32, Int32, CancellationToken)	从此流中异步读取数据，并将其存储在字节数组的指定范围中。

ReadAsync(Memory<Byte>, CancellationToken)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: 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)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: 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 中从零开始的位置，从此处开始存储从此流中读取的数据。

count: Int32

要从此流中读取的最大字节数。

cancellationToken: CancellationToken

要监视取消请求的标记。

Task<Int32>

表示异步读取操作的任务。其 Result 属性的值包含读入 buffer 的总字节数。如果再也没有要读取的数据，将返回 0。

例外

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

offset 小于 0。

或

count 小于 0。

或

count 大于 buffer 的长度减去 offset。