SslStream.ReadAsync 方法

定义

命名空间:: System.Net.Security

程序集:: netstandard.dll

重要

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

重载

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

ReadAsync(Memory<Byte>, CancellationToken)

从此流异步读取数据并将其存储在指定的内存范围内。

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)

从此流异步读取数据，并将其存储在字节数组的指定范围内。

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长度。