BufferedStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

BufferedStream.cs

Zahájí asynchronní operaci čtení. (Zvažte místo toho použití ReadAsync(Byte[], Int32, Int32, CancellationToken) .)

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);

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

Parametry

buffer

Byte[]

Vyrovnávací paměť pro čtení dat.

offset

Int32

Posun bajtů, při buffer kterém se mají začít zapisovat data načtená z datového proudu.

count

Int32

Maximální počet bajtů ke čtení.

callback

AsyncCallback

Volitelné asynchronní zpětné volání, které se má volat po dokončení čtení.

state

Object

Uživatelem zadaný objekt, který odlišuje tento konkrétní asynchronní požadavek na čtení od ostatních požadavků.

Návraty

IAsyncResult

Objekt, který představuje asynchronní čtení, které může být stále čeká na vyřízení.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset nebo count je negativní.

IOException

Došlo k pokusu o asynchronní čtení za koncem datového proudu.

ArgumentException

Délka vyrovnávací paměti mínus offset je menší než count.

NotSupportedException

Aktuální datový proud nepodporuje operaci čtení.

Poznámky

V rozhraní .NET Framework 4 a starších verzích musíte k implementaci asynchronních operací se soubory použít metody, jako BeginRead jsou a EndRead . Tyto metody jsou stále k dispozici v rozhraní .NET Framework 4.5 pro podporu starší verze kódu; Nové asynchronní metody, jako ReadAsyncjsou , WriteAsynca FlushAsync, však pomáhají snadněji implementovat asynchronní operace se soubory.

EndWrite musí být volána přesně jednou pro každé volání metody BeginRead. Selhání ukončení procesu čtení před zahájením dalšího čtení může způsobit nežádoucí chování, jako je například zablokování.

Poznámka

CanRead Pomocí vlastnosti určete, zda aktuální instance podporuje čtení.

EndRead Musí být volána s tímto IAsyncResult kódem, aby se zjistilo, kolik bajtů bylo přečteno.