StringReader.ReadBlockAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| ReadBlockAsync(Memory<Char>, CancellationToken) |
Läser asynkront alla tecken från indatasträngen från den aktuella positionen och flyttar den aktuella positionen till slutet av indatasträngen. |
| ReadBlockAsync(Char[], Int32, Int32) |
Läser ett angivet maximalt antal tecken från den aktuella strängen asynkront och skriver data till en buffert med början vid det angivna indexet. |
ReadBlockAsync(Memory<Char>, CancellationToken)
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
Läser asynkront alla tecken från indatasträngen från den aktuella positionen och flyttar den aktuella positionen till slutet av indatasträngen.
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)Parametrar
När den här metoden returnerar innehåller tecknen som lästs från den aktuella källan. Om det totala antalet tecken som läses är noll förblir intervallet oförändrad.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller det totala antalet tecken som lästs in i bufferten.
Undantag
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
ReadBlockAsync(Memory<Char>, CancellationToken) anropar ReadBlock(Span<Char>) asynkront, vilket i sin tur anropar Read(Span<Char>) direkt.
Gäller för
ReadBlockAsync(Char[], Int32, Int32)
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
- Källa:
- StringReader.cs
Läser ett angivet maximalt antal tecken från den aktuella strängen asynkront och skriver data till en buffert med början vid det angivna indexet.
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)Parametrar
- buffer
- Char[]
När den här metoden returnerar innehåller den angivna teckenmatrisen med värdena mellan index och (index + count - 1) ersatta av de tecken som lästs från den aktuella källan.
- index
- Int32
Den position buffer där du ska börja skriva.
- count
- Int32
Det maximala antalet tecken som ska läsas. Om slutet av strängen nås innan det angivna antalet tecken skrivs till bufferten returnerar metoden.
Returer
En uppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller det totala antalet byte som lästs in i bufferten. Resultatvärdet kan vara mindre än det antal byte som begärs om antalet tillgängliga byte för närvarande är mindre än det begärda talet, eller om det kan vara 0 (noll) om slutet av strängen har nåtts.
- Attribut
Undantag
buffer är null.
index eller count är negativ.
Summan av index och count är större än buffertlängden.
Strängläsaren har tagits bort.
Läsaren används för närvarande av en tidigare läsåtgärd.
Kommentarer
Uppgiften slutförs inte förrän antingen antalet tecken som anges av parametern count har lästs eller så har slutet på strängen nåtts.
