Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lit au moins un nombre minimal d’octets 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 -> intPublic Function ReadAtLeast (buffer As Span(Of Byte), minimumBytes As Integer, Optional throwOnEndOfStream As Boolean = true) As IntegerParamètres
Une région de 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 d’octets ; false pour retourner moins que minimumBytes lorsque la fin du flux est atteinte.
La valeur par défaut est true.
Retours
Nombre total d’octets lus dans la mémoire tampon. Il est garanti qu’il soit supérieur ou égal à minimumBytes quand throwOnEndOfStreamtrue. Cela sera inférieur minimumBytes au moment où la fin du flux est atteinte et throwOnEndOfStream est false. Cela peut être inférieur au nombre d’octets alloués dans la mémoire tampon si de nombreux octets ne sont pas actuellement disponibles.
Exceptions
minimumBytes est négatif, ou est supérieur à la longueur de buffer.
throwOnEndOfStream est et la fin du flux est true atteinte avant de lire minimumBytes des octets de données.
Remarques
Lorsque minimumBytes la valeur est 0 (zéro), cette opération de lecture est terminée sans attendre que les données disponibles soient disponibles dans le flux.
