NetworkStream.WriteAsync 方法

定义

命名空间:: System.Net.Sockets

程序集:: netstandard.dll

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

重要

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

重载

名称	说明
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	NetworkStream将数据作为异步操作从只读内存字节内存范围写入数据。
WriteAsync(Byte[], Int32, Int32, CancellationToken)	将数据作为异步操作写入 NetworkStream 字节数组的指定范围。

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

用于监视取消请求的令牌。

ValueTask

表示异步写入作的任务。

例外

InvalidOperationException

不支持 NetworkStream 写入。

IOException

访问套接字时出错。

-或-

写入网络时出现故障。

ObjectDisposedException

关闭 NetworkStream 。

OperationCanceledException

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

注解

此方法将所有字节 buffer 发送到网络。

注释

通过调用CanWrite属性来检查该属性是否NetworkStream可写。如果尝试写入不可写的， NetworkStream 你将获得一个 InvalidOperationException。

注释

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

适用于

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

将数据作为异步操作写入 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(byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);

abstract member WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
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

参数

buffer: Byte[]

包含要写入到的 NetworkStream数据的字节数组。

offset: Int32

从中开始写入数据的位置 buffer 。

countsize: Int32

要写入到的 NetworkStream字节数。

cancellationToken: CancellationToken

用于监视取消请求的令牌。

Task

表示异步写入作的任务。

例外

ArgumentNullException

参数 buffer 为 null.

ArgumentOutOfRangeException

参数 offset 小于 0。

-或-

参数 offset 的长度 buffer大于。

-或-

参数 size 小于 0。

-或-

该size参数大于减去参数值的buffer长度offset。