Stream.ReadExactlyAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

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

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

ValueTask

Attività che rappresenta l'operazione di lettura asincrona.

Eccezioni

EndOfStreamException

La fine del flusso viene raggiunta prima di riempire .buffer

OperationCanceledException

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.

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

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

ValueTask

Attività che rappresenta l'operazione di lettura asincrona.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentOutOfRangeException

offset non rientra nei limiti di buffer.

-oppure-

count è negativo.

-oppure-

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

EndOfStreamException

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

OperationCanceledException

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).