NetworkStream.ReadAsync 方法

参考

定义

命名空间:: System.Net.Sockets

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

程序集:: netstandard.dll

重要

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

重载

ReadAsync(Memory<Byte>, CancellationToken)	以异步操作形式，从 NetworkStream 读取数据，并将其存储在字节内存范围内。
ReadAsync(Byte[], Int32, Int32, CancellationToken)	以异步操作形式，从 NetworkStream 读取数据，并将其存储到字节数组的指定范围内。

ReadAsync(Memory<Byte>, CancellationToken)

Source:: NetworkStream.cs

Source:: NetworkStream.cs

Source:: NetworkStream.cs

以异步操作形式，从 NetworkStream 读取数据，并将其存储在字节内存范围内。

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>

表示异步读取操作的 ValueTask<TResult>。其 Result 属性的值包含读入 buffer 的总字节数。

例外

InvalidOperationException

NetworkStream 不支持读取。

IOException

访问套接字时出错。

- 或 -

从网络读取时出错。

ObjectDisposedException

NetworkStream 是关闭的。

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

此方法读取的数据量与可用 buffer 数据量一样多，并返回成功读取的字节数。

备注

通过调用 CanRead 属性检查是否NetworkStream可读。如果尝试从不可读的读取 NetworkStream ，你将获得 InvalidOperationException。

备注

如果收到，IOException检查 InnerException 属性，以确定它是否由 SocketException引起。如果是这样，请使用 ErrorCode 属性获取特定的错误代码，并参阅 Windows 套接字版本 2 API 错误代码文档，了解错误的详细说明。

适用于

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

Source:: NetworkStream.cs

Source:: NetworkStream.cs

Source:: NetworkStream.cs

以异步操作形式，从 NetworkStream 读取数据，并将其存储到字节数组的指定范围内。

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken 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 size, 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>

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

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

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 中开始将数据存储到的位置。

sizecount: Int32

要从 NetworkStream 中读取的字节数。

cancellationToken: CancellationToken