Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

Stream.cs

Liest mindestens eine Mindestanzahl von Bytes aus dem aktuellen Stream und erhöht die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes.

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

Parameter

buffer

Span<Byte>

Ein Bereich im Arbeitsspeicher. Wenn diese Methode zurückgibt, werden die Inhalte dieser Region durch die bytes ersetzt, die aus dem aktuellen Stream gelesen werden.

minimumBytes

Int32

Die Mindestanzahl von Bytes, die in den Puffer eingelesen werden sollen.

throwOnEndOfStream

Boolean

true , um eine Ausnahme auszulösen, wenn das Ende des Datenstroms vor dem Lesen minimumBytes von Bytes erreicht wird, false um weniger zurückzugeben, als minimumBytes wenn das Ende des Datenstroms erreicht ist. Der Standardwert lautet true.

Gibt zurück

Int32

Die Gesamtanzahl der in den Puffer gelesenen Bytes. Dies ist garantiert größer oder gleich minimumBytes , wenn throwOnEndOfStream ist true. Dies ist weniger als minimumBytes , wenn das Ende des Datenstroms erreicht wird und throwOnEndOfStream ist false. Dies kann kleiner als die Anzahl der im Puffer zugewiesenen Bytes sein, wenn diese anzahl von Bytes derzeit nicht verfügbar ist.

Ausnahmen

ArgumentOutOfRangeException

minimumBytes ist negativ oder ist größer als die Länge von buffer.

EndOfStreamException

throwOnEndOfStream ist true und das Ende des Datenstroms vor dem Lesen minimumBytes von Datenbytes erreicht wird.

Hinweise

Wenn minimumBytes 0 (null) ist, wird dieser Lesevorgang abgeschlossen, ohne auf verfügbare Daten im Stream zu warten.