Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Legge almeno un numero minimo di byte dal flusso corrente e sposta in avanti la posizione all'interno del flusso in base al numero di byte letti.
public int ReadAtLeast(Span<byte> buffer, int minimumBytes, bool throwOnEndOfStream = true);
member this.ReadAtLeast : Span<byte> * int * bool -> int
Public Function ReadAtLeast (buffer As Span(Of Byte), minimumBytes As Integer, Optional throwOnEndOfStream As Boolean = true) As Integer
Parametri
Area di memoria. Quando termina, il contenuto di questa area viene sostituito dai byte letti dal flusso corrente.
- minimumBytes
- Int32
Numero minimo di byte da leggere nel buffer.
- throwOnEndOfStream
- Boolean
true per generare un'eccezione se viene raggiunta la fine del flusso prima della lettura minimumBytes di byte; false per restituire meno di minimumBytes quando viene raggiunta la fine del flusso.
Il valore predefinito è true.
Valori restituiti
Numero totale di byte letti nel buffer. È garantito che sia maggiore o uguale a minimumBytes quando throwOnEndOfStream è true. Questo valore sarà minore di quando minimumBytes viene raggiunta la fine del flusso e throwOnEndOfStream è false. Può essere minore del numero di byte allocati nel buffer se non sono attualmente disponibili molti byte.
Eccezioni
minimumBytes è negativo o è maggiore della lunghezza di buffer.
throwOnEndOfStream è true e la fine del flusso viene raggiunta prima di leggere minimumBytes byte di dati.
Commenti
Quando minimumBytes è 0 (zero), questa operazione di lettura verrà completata senza attendere i dati disponibili nel flusso.