NetworkStream.WriteAsync 方法

定义

命名空间:

System.Net.Sockets

程序集:

netstandard.dll, System.Net.Sockets.dll

重载

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

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:

NetworkStream.cs

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 发送到网络。

注释

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

注释

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

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

Source:

NetworkStream.cs

将数据作为异步操作写入 NetworkStream 字节数组的指定范围。

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

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

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

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

参数

buffer

Byte[]

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

offset

Int32

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

count

Int32

要写入到的 NetworkStream字节数。

cancellationToken

CancellationToken

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

返回

Task

表示异步写入作的任务。

例外

ArgumentNullException

参数 buffer 为 null.

ArgumentOutOfRangeException

参数 offset 小于 0。

-或-

参数 offset 的长度 buffer大于 。

-或-

参数 size 小于 0。

-或-

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

InvalidOperationException

不支持 NetworkStream 写入。

IOException

写入网络时出现故障。

-或-

访问套接字时出错。

ObjectDisposedException

关闭 NetworkStream 。

OperationCanceledException

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

注解

此方法从指定的offset位置开始，并将字节从网络的内容count发送到buffer网络。

注释

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

注释

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

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 Write(Byte[], Int32, Int32)..