Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

Stream.cs

Lit au moins un nombre minimal d’octets à partir du flux actuel et avance la position dans le flux par le nombre d’octets lus.

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

Paramètres

buffer

Span<Byte>

Région de la mémoire. Lorsque cette méthode est retournée, le contenu de cette région est remplacé par les octets lus à partir du flux actuel.

minimumBytes

Int32

Nombre minimal d’octets à lire dans la mémoire tampon.

throwOnEndOfStream

Boolean

true pour lever une exception si la fin du flux est atteinte avant la lecture minimumBytes des octets ; false pour retourner moins que minimumBytes lorsque la fin du flux est atteinte. Par défaut, il s’agit de true.

Retours

Int32

Nombre total d'octets lus dans la mémoire tampon. Cette valeur est garantie supérieure ou égale à minimumBytes quand throwOnEndOfStream est true. Cette valeur sera inférieure minimumBytes à celle de la fin du flux et throwOnEndOfStream de la valeur false. Cela peut être inférieur au nombre d’octets alloués dans la mémoire tampon si ce nombre n’est pas disponible actuellement.

Exceptions

ArgumentOutOfRangeException

minimumBytes est négatif ou est supérieur à la longueur de buffer.

EndOfStreamException

throwOnEndOfStream est true et la fin du flux est atteinte avant la lecture minimumBytes des octets de données.

Remarques

Lorsque minimumBytes la valeur est égale à 0 (zéro), cette opération de lecture est terminée sans attendre les données disponibles dans le flux.