StringReader.ReadBlockAsync 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 |
|---|---|
| ReadBlockAsync(Memory<Char>, CancellationToken) |
Asynchroon worden alle tekens uit de invoertekenreeks vanaf de huidige positie gelezen en wordt de huidige positie naar het einde van de invoertekenreeks doorgegaan. |
| ReadBlockAsync(Char[], Int32, Int32) |
Leest een opgegeven maximum aantal tekens uit de huidige tekenreeks asynchroon en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index. |
ReadBlockAsync(Memory<Char>, CancellationToken)
Asynchroon worden alle tekens uit de invoertekenreeks vanaf de huidige positie gelezen en wordt de huidige positie naar het einde van de invoertekenreeks doorgegaan.
public override System.Threading.Tasks.ValueTask<int> ReadBlockAsync(Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Overrides Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parameters
Wanneer deze methode wordt geretourneerd, bevat deze tekens die uit de huidige bron worden gelezen. Als het totale aantal gelezen tekens nul is, blijft de periode ongewijzigd.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van de TResult parameter bevat het totale aantal tekens dat in de buffer wordt gelezen.
Uitzonderingen
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
ReadBlockAsync(Memory<Char>, CancellationToken) roept ReadBlock(Span<Char>) asynchroon aan, die op zijn beurt rechtstreeks aanroept Read(Span<Char>) .
Van toepassing op
ReadBlockAsync(Char[], Int32, Int32)
Leest een opgegeven maximum aantal tekens uit de huidige tekenreeks asynchroon en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index.
public:
override System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);public override System.Threading.Tasks.Task<int> ReadBlockAsync(char[] buffer, int index, int count);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<int> ReadBlockAsync(char[] buffer, int index, int count);override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>Public Overrides Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)Parameters
- buffer
- Char[]
Wanneer deze methode wordt geretourneerd, bevat de opgegeven tekenmatrix met de waarden tussen index en (index + count - 1) vervangen door de tekens die uit de huidige bron worden gelezen.
- index
- Int32
De positie buffer waarin moet worden geschreven.
- count
- Int32
Het maximum aantal tekens dat moet worden gelezen. Als het einde van de tekenreeks wordt bereikt voordat het opgegeven aantal tekens in de buffer wordt geschreven, retourneert de methode.
Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van de TResult parameter bevat het totale aantal bytes dat in de buffer is gelezen. De resultaatwaarde kan kleiner zijn dan het aantal aangevraagde bytes als het aantal beschikbare bytes kleiner is dan het aangevraagde getal, of het kan 0 (nul) zijn als het einde van de tekenreeks is bereikt.
- Kenmerken
Uitzonderingen
buffer is null.
index of count is negatief.
De som van index en count is groter dan de bufferlengte.
De tekenreekslezer is verwijderd.
De lezer wordt momenteel gebruikt door een eerdere leesbewerking.
Opmerkingen
De taak wordt pas voltooid als het aantal tekens dat door de count parameter is opgegeven, wordt gelezen of het einde van de tekenreeks is bereikt.