SerialPort.ReadByte Método

Definición

Espacio de nombres:

System.IO.Ports

Ensamblado:

System.IO.Ports.dll

Paquete:

System.IO.Ports v8.0.0

Source:

SerialPort.cs

Lee sincrónicamente un byte del búfer de entrada de SerialPort.

C#

public int ReadByte ();

Devoluciones

Int32

El byte, convertido en un Int32, o -1 si se ha leído el final de la secuencia.

Excepciones

InvalidOperationException

El puerto especificado no está abierto.

TimeoutException

La operación no se ha terminado antes de que transcurriera el tiempo de espera.

o bien

No se leyó ningún byte.

Comentarios

Este método lee un byte.

Tenga cuidado al usar ReadByte y ReadChar juntos. El cambio entre bytes de lectura y caracteres de lectura puede hacer que se lean datos adicionales u otro comportamiento no deseado. Si es necesario cambiar entre leer texto y leer datos binarios de la secuencia, seleccione un protocolo que defina cuidadosamente el límite entre texto y datos binarios, como leer bytes manualmente y descodificar los datos.

Nota

Dado que la clase almacena en búfer los SerialPort datos y la secuencia contenida en la BaseStream propiedad no, los dos podrían entrar en conflicto sobre cuántos bytes están disponibles para leerse. La BytesToRead propiedad puede indicar que hay bytes para leer, pero es posible que estos bytes no sean accesibles para la secuencia contenida en la BaseStream propiedad porque se han almacenado en búfer en la SerialPort clase .

Se aplica a