Compartir a través de


Stream.ReadByte Método

Definición

Lee un byte de la secuencia y hace avanzar la posición de la secuencia en un byte, o devuelve -1 si está al final de la secuencia.

public:
 virtual int ReadByte();
public virtual int ReadByte ();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer

Devoluciones

Byte sin signo convertido en Int32,o bien -1 si está al final de la secuencia.

Excepciones

La secuencia no admite lectura.

Se efectuó una llamada a los métodos después de cerrar la secuencia.

Comentarios

Utilice la CanRead propiedad para determinar si la instancia actual admite la lectura.

Los intentos de manipular la secuencia después de cerrar la secuencia podrían producir una ObjectDisposedExceptionexcepción .

Notas a los desarrolladores de herederos

La implementación predeterminada en crea Stream una nueva matriz de un solo byte y, a continuación, llama a Read(Byte[], Int32, Int32). Aunque esto es formalmente correcto, es ineficaz. Cualquier secuencia con un búfer interno debe invalidar este método y proporcionar una versión mucho más eficaz que lea el búfer directamente, evitando la asignación de matriz adicional en cada llamada.

Se aplica a

Consulte también