CryptoStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zahájí asynchronní operaci čtení. (Zvažte místo toho použití 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
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
Představuje IAsyncResult asynchronní čtení, které může být stále čeká na vyřízení.
Výjimky
Došlo k pokusu o asynchronní čtení za koncem datového proudu nebo došlo k chybě disku.
Jeden nebo více argumentů je neplatných.
Metody byly volány po uzavření datového proudu.
Aktuální Stream
implementace nepodporuje operaci čtení.
Poznámky
Důležité
Počínaje verzí .NET 6 nemusí tato metoda číst tolik bajtů, kolik bylo požadováno. Další informace naleznete v části Částečné a nulové čtení v DeflateStream, GZipStream a CryptoStream.
V rozhraní .NET Framework 4 a starších verzích musíte k implementaci asynchronních vstupně-výstupních operací použít metody jako BeginRead a EndRead . Tyto metody jsou stále k dispozici v aktuálních verzích pro podporu staršího kódu; Nové asynchronní metody, jako ReadAsyncjsou , WriteAsyncCopyToAsync, a FlushAsync, však pomáhají snadněji implementovat asynchronní vstupně-výstupní operace.
Předáním návratové IAsyncResult
hodnoty metodě EndRead datového proudu určíte, kolik bajtů bylo přečteno, a uvolní prostředky operačního systému používané ke čtení. EndReadmusí být volána jednou pro každé volání .BeginRead Můžete to provést buď pomocí stejného kódu, který volal BeginRead
, nebo ve zpětném volání předaném do BeginRead
.
Aktuální pozice v datovém proudu se aktualizuje při asynchronním čtení nebo zápisu, ne při dokončení vstupně-výstupní operace.
Více souběžných asynchronních požadavků vykreslí pořadí dokončení požadavků na nejisté.
CanRead Pomocí vlastnosti určete, zda aktuální instance podporuje čtení.
Pokud je datový proud uzavřen nebo předáte neplatný argument, jsou výjimky vyvolány okamžitě z BeginRead
. Chyby, ke kterým dochází během asynchronního požadavku na čtení, jako je například selhání disku během V/V požadavku, se vyskytují ve vlákně fondu vláken a při volání EndRead
vyvolají výjimky .
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro