IsolatedStorageFileStream.ReadAsync 方法

定义

命名空间:

System.IO.IsolatedStorage

程序集:

System.IO.IsolatedStorage.dll

重载

ReadAsync(Byte[], Int32, Int32, CancellationToken)	将字节从当前缓冲的 IsolatedStorageFileStream 对象异步复制到字节数组。
ReadAsync(Memory<Byte>, CancellationToken)	将字节从当前缓冲的 IsolatedStorageFileStream 对象异步复制到字节内存范围。

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

Source:

IsolatedStorageFileStream.cs

将字节从当前缓冲的 IsolatedStorageFileStream 对象异步复制到字节数组。

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

缓冲区中开始写入的偏移量。

count

Int32

最多读取的字节数。

cancellationToken

CancellationToken

要监视取消请求的标记。 默认值为 None。

返回

Task<Int32>

表示异步读取操作的任务。 它会包装读入 buffer 中的总字节数。 如果当前可用的字节数没有请求的字节数那么多，则总字节数可能小于请求的字节数；如果已到达流的末尾，则为零。

例外

OperationCanceledException

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

注解

参数buffer可以是 类的Buffer实例，也可以是以下类型之一的数组：Byte、、SByte、Char、Int16、Int32、UInt32UInt16UInt64Int64、 Single或 。Double

如果读取操作成功，则流的当前位置将按读取的字节数前进。 如果发生异常，流的当前位置保持不变。

方法 ReadAsync 将 buffer 参数视为字节块，而不考虑其实际类型。 同样， offset 和 count 参数始终以字节为单位指定。 对于 buffer 字节数组以外的参数，这意味着元素索引或元素数必须乘以元素大小（以字节为单位）才能为 offset 或 count形成正确的值。

ReadAsync仅当到达流的末尾时， 方法才会返回零。 在所有其他情况下， ReadAsync 始终在返回之前至少从流中读取一个字节。 如果在调用 ReadAsync时对象中没有可用IsolatedStorageFileStream数据，则方法将阻塞，直到至少可以返回一个字节的数据。

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

ReadAsync(Memory<Byte>, CancellationToken)

Source:

IsolatedStorageFileStream.cs

将字节从当前缓冲的 IsolatedStorageFileStream 对象异步复制到字节内存范围。

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

要监视取消请求的标记。 默认值为 None。

返回

ValueTask<Int32>

表示异步读取操作的任务。 它会包装读入 buffer 中的总字节数。 如果当前可用的字节数没有请求的字节数那么多，则总字节数可能小于请求的字节数；如果已到达流的末尾，则为零。

例外

OperationCanceledException

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