Stream.ReadExactlyAsync Metodo

Definizione

Overload

Nome Descrizione
ReadExactlyAsync(Memory<Byte>, CancellationToken)

Legge in modo asincrono i byte dal flusso corrente, sposta la posizione all'interno del flusso fino a quando non buffer viene riempita e monitora le richieste di annullamento.

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

Legge count in modo asincrono il numero di byte dal flusso corrente, sposta in avanti 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
Origine:
Stream.cs
Origine:
Stream.cs

Legge in modo asincrono i byte dal flusso corrente, sposta la posizione all'interno del flusso fino a quando 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.

Valori restituiti

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 è vuota, 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
Origine:
Stream.cs
Origine:
Stream.cs

Legge count in modo asincrono il numero di byte dal flusso corrente, sposta in avanti 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 di byte in in buffer corrispondenza del quale iniziare a scrivere dati dal flusso.

count
Int32

Numero di byte da leggere dal flusso corrente.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.

Valori restituiti

Attività che rappresenta l'operazione di lettura asincrona.

Eccezioni

buffer è null.

offset non rientra nei limiti di buffer.

oppure

count è negativo.

oppure

L'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