Compartir a través de


SerialPort.ReadByte Método

Definición

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

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

Devoluciones

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

Excepciones

El puerto especificado no está abierto.

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