Stream.ReadExactlyAsync Methode

Definitie

Overloads

Name Description
ReadExactlyAsync(Memory<Byte>, CancellationToken)

Asynchroon leest bytes uit de huidige stroom, verplaatst de positie binnen de stream totdat de buffer stroom is ingevuld en bewaakt annuleringsaanvragen.

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

Asynchroon leest count het aantal bytes uit de huidige stroom, verplaatst de positie binnen de stream en bewaakt annuleringsaanvragen.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Bron:
Stream.cs
Bron:
Stream.cs
Bron:
Stream.cs
Bron:
Stream.cs
Bron:
Stream.cs

Asynchroon leest bytes uit de huidige stroom, verplaatst de positie binnen de stream totdat de buffer stroom is ingevuld en bewaakt annuleringsaanvragen.

public System.Threading.Tasks.ValueTask ReadExactlyAsync(Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parameters

buffer
Memory<Byte>

De buffer om de gegevens naar te schrijven.

cancellationToken
CancellationToken

Het token dat moet worden gecontroleerd op annuleringsaanvragen.

Retouren

Een taak die de asynchrone leesbewerking vertegenwoordigt.

Uitzonderingen

Het einde van de stream wordt bereikt voordat de bufferstroom wordt gevuld.

Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.

Opmerkingen

Wanneer buffer deze leesbewerking leeg is, wordt deze leesbewerking voltooid zonder te wachten op beschikbare gegevens in de stream.

Van toepassing op

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

Bron:
Stream.cs
Bron:
Stream.cs
Bron:
Stream.cs
Bron:
Stream.cs
Bron:
Stream.cs

Asynchroon leest count het aantal bytes uit de huidige stroom, verplaatst de positie binnen de stream en bewaakt annuleringsaanvragen.

public System.Threading.Tasks.ValueTask ReadExactlyAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);
member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parameters

buffer
Byte[]

De buffer om de gegevens naar te schrijven.

offset
Int32

De byte-offset buffer waarin gegevens uit de stream moeten worden geschreven.

count
Int32

Het aantal bytes dat moet worden gelezen uit de huidige stream.

cancellationToken
CancellationToken

Het token dat moet worden gecontroleerd op annuleringsaanvragen.

Retouren

Een taak die de asynchrone leesbewerking vertegenwoordigt.

Uitzonderingen

buffer is null.

offset valt buiten de grenzen van buffer.

– of –

count is negatief.

– of –

Het bereik dat is opgegeven door de combinatie van offset en count overschrijdt de lengte van buffer.

Het einde van de stream wordt bereikt voordat het aantal bytes wordt gelezen count .

Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.

Opmerkingen

Wanneer count is 0 (nul), wordt deze leesbewerking voltooid zonder te wachten op beschikbare gegevens in de stream.

Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ReadExactly(Byte[], Int32, Int32)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.

Van toepassing op