SslStream.ReadAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| ReadAsync(Memory<Byte>, CancellationToken) |
Gegevens uit deze stream worden asynchroon gelezen en opgeslagen in het opgegeven geheugenbereik. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Gegevens uit deze stroom worden asynchroon gelezen en opgeslagen in het opgegeven bereik van een bytematrix. |
ReadAsync(Memory<Byte>, CancellationToken)
Gegevens uit deze stream worden asynchroon gelezen en opgeslagen in het opgegeven geheugenbereik.
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)Parameters
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van Result de eigenschap bevat het totale aantal bytes dat is gelezen in buffer. Als er geen gegevens meer moeten worden gelezen, wordt 0 geretourneerd.
Uitzonderingen
Er is geen verificatie opgetreden.
De leesbewerking is mislukt. Controleer de interne uitzondering, als deze aanwezig is, om de oorzaak van de fout te bepalen.
Er wordt al een leesbewerking uitgevoerd.
Dit object is gesloten.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Met deze methode worden zoveel gegevens gelezen als beschikbaar is in de buffer.
U kunt niet meerdere gelijktijdige leesbewerkingen uitvoeren.
U kunt deze methode pas aanroepen als u bent geverifieerd.
Van toepassing op
ReadAsync(Byte[], Int32, Int32, CancellationToken)
Gegevens uit deze stroom worden asynchroon gelezen en opgeslagen in het opgegeven bereik van een bytematrix.
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)Parameters
- buffer
- Byte[]
De buffer die de bytes ontvangt die uit deze stream zijn gelezen.
- offset
- Int32
De op nul gebaseerde locatie buffer waar de gegevens uit deze stroom moeten worden opgeslagen.
- count
- Int32
Het maximum aantal bytes dat uit deze stream moet worden gelezen.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van Result de eigenschap bevat het totale aantal bytes dat is gelezen in buffer. Als er geen gegevens meer moeten worden gelezen, wordt 0 geretourneerd.
Uitzonderingen
buffer is null.
offset is kleiner dan 0.
– of –
count is kleiner dan 0.
– of –
count is groter dan de lengte van buffer min offset.
Er is geen verificatie opgetreden.
De leesbewerking is mislukt. Controleer de interne uitzondering, als deze aanwezig is, om de oorzaak van de fout te bepalen.
Er wordt al een leesbewerking uitgevoerd.
Dit object is gesloten.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
De methode leest maximaal bytes uit count de stream en slaat deze op offsetvanaf buffer .
U kunt niet meerdere gelijktijdige leesbewerkingen uitvoeren.
U kunt deze methode pas aanroepen als u bent geverifieerd.
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 Read(Byte[], Int32, Int32)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.