信息
您所需的主题如下所示。但此主题未包含在此库中。

Stream.WriteAsync 方法 (Byte[], Int32, Int32)

2013/12/13

将字节序列异步写入当前流,并将流的当前位置向前移动写入的字节数。

Namespace:  System.IO
程序集:  mscorlib(位于 mscorlib.dll 中)

public Task WriteAsync(
	byte[] buffer,
	int offset,
	int count
)

参数

buffer
类型: System.Byte []
从中写入数据的缓冲区。
offset
类型: System.Int32
buffer 中的从零开始的字节偏移量,从此处开始将字节复制到流。
count
类型: System.Int32
写入的最大字节数。

返回值

类型: System.Threading.Tasks.Task
表示异步写入操作的任务。

异常条件
ArgumentNullException

buffernull

ArgumentOutOfRangeException

offsetcount 为负。

ArgumentException

offsetcount 的和大于缓冲区长度。

NotSupportedException

流不支持写入。

ObjectDisposedException

流已被释放。

InvalidOperationException

流当前正由上一写入操作使用。

WriteAsync 方法使您能够执行资源密集型 I/O 操作,而不阻塞主线程。此性能注意事项在 Windows 商店 应用或 桌面 应用中尤其重要,因为在上述应用中,耗时的流操作可阻塞 UI 线程,并使您的应用看似未在工作。在 Visual Basic 和 C# 中,async 方法与 asyncawait 关键字结合使用。

使用 CanWrite 属性可确定当前实例是否支持读取。

Windows Phone OS

受以下版本支持: 8.0

显示: