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

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

Stream.cs

Lee al menos un número mínimo de bytes de la secuencia actual y avanza la posición dentro de la secuencia por el número de bytes leídos.

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

Parámetros

buffer

Span<Byte>

Región de memoria. Cuando este método devuelve, el contenido de esta región se reemplaza por los bytes leídos de la secuencia actual.

minimumBytes

Int32

Número mínimo de bytes que se van a leer en el búfer.

throwOnEndOfStream

Boolean

true para producir una excepción si se alcanza el final de la secuencia antes de leer minimumBytes bytes; false para devolver menos que minimumBytes cuando se alcanza el final de la secuencia. El valor predeterminado es true.

Devoluciones

Int32

Número total de bytes leídos en el búfer. Se garantiza que es mayor o igual que minimumBytes cuando throwOnEndOfStream es true. Será menor que minimumBytes cuando se alcance el final de la secuencia y throwOnEndOfStream sea false. Puede ser menor que el número de bytes asignados en el búfer si muchos bytes no están disponibles actualmente.

Excepciones

ArgumentOutOfRangeException

minimumBytes es negativo o es mayor que la longitud de buffer.

EndOfStreamException

throwOnEndOfStream es true y se alcanza el final de la secuencia antes de leer minimumBytes bytes de datos.

Comentarios

Cuando minimumBytes es 0 (cero), esta operación de lectura se completará sin esperar a que haya datos disponibles en la secuencia.