Condividi tramite


Stream.ReadExactlyAsync Metodo

Definizione

Overload

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Legge in modo asincrono i byte dal flusso corrente, avanza la posizione all'interno del flusso finché non buffer viene riempita e monitora le richieste di annullamento.

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

Legge in modo count asincrono il numero di byte dal flusso corrente, sposta la posizione all'interno del flusso e monitora le richieste di annullamento.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Origine:
Stream.cs
Origine:
Stream.cs
Origine:
Stream.cs

Legge in modo asincrono i byte dal flusso corrente, avanza la posizione all'interno del flusso finché non buffer viene riempita e monitora le richieste di annullamento.

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

Parametri

buffer
Memory<Byte>

Buffer in cui scrivere i dati.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.

Restituisce

Attività che rappresenta l'operazione di lettura asincrona.

Eccezioni

La fine del flusso viene raggiunta prima di riempire .buffer

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Quando buffer è vuoto, questa operazione di lettura verrà completata senza attendere i dati disponibili nel flusso.

Si applica a

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

Origine:
Stream.cs
Origine:
Stream.cs
Origine:
Stream.cs

Legge in modo count asincrono il numero di byte dal flusso corrente, sposta la posizione all'interno del flusso e monitora le richieste di annullamento.

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

Parametri

buffer
Byte[]

Buffer in cui scrivere i dati.

offset
Int32

Offset dei byte in buffer da cui iniziare la scrittura dei dati dal flusso.

count
Int32

Numero di byte da leggere dal flusso corrente.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.

Restituisce

Attività che rappresenta l'operazione di lettura asincrona.

Eccezioni

buffer è null.

offset non rientra nei limiti di buffer.

-oppure-

count è negativo.

-oppure-

Intervallo specificato dalla combinazione di offset e count supera la lunghezza di buffer.

La fine del flusso viene raggiunta prima del numero di byte di lettura count .

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Quando count è 0 (zero), questa operazione di lettura verrà completata senza attendere i dati disponibili nel flusso.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ReadExactly(Byte[], Int32, Int32).

Si applica a