CryptoStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) 方法

定义

开始异步读操作。 (请考虑改用 ReadAsync。)

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

参数

buffer
Byte[]

数据读入的缓冲区。

offset
Int32

buffer 中的字节偏移量,从该偏移量开始写入从流中读取的数据。

count
Int32

最多读取的字节数。

callback
AsyncCallback

可选的异步回调,在完成读取时调用。

state
Object

一个用户提供的对象,它将该特定的异步读取请求与其他请求区别开来。

返回

表示异步读取的 IAsyncResult(可能仍处于挂起状态)。

例外

尝试的异步读取超过了流的结尾,或者发生了磁盘错误。

一个或多个自变量无效。

在流关闭后调用方法。

当前 Stream 实现不支持读取操作。

注解

重要

从 .NET 6 开始,此方法读取的字节数可能与请求的字节数不一样多。 有关详细信息,请参阅 DeflateStream、GZipStream 和 CryptoStream 中的部分读取和零字节读取

在 .NET Framework 4 和更早的版本中,你必须使用 BeginReadEndRead 等方法来实现异步 I/O 操作。 这些方法在当前版本中仍可用,以支持旧代码;但是,新的异步方法(如 ReadAsyncWriteAsyncCopyToAsyncFlushAsync)可帮助你更轻松地实现异步 I/O 操作。

IAsyncResult 返回值传递给 EndRead 流的 方法,以确定读取的字节数并释放用于读取的操作系统资源。 EndRead 每次调用 BeginRead都必须调用一次。 为此,可以使用调用 或 传递到 的回调中调用 BeginRead 或 的 BeginRead相同代码。

当发出异步读取或写入时,而不是 I/O 操作完成时,流中的当前位置会更新。

多个同步异步请求使请求完成顺序不确定。

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

如果流关闭或传递了无效参数,则会立即从 BeginRead引发异常。 异步读取请求期间发生的错误(例如 I/O 请求期间的磁盘故障)发生在线程池线程上,并在调用 EndRead时引发异常。

适用于