SerialPort.ReadChar Método

Definición

Lee sincrónicamente un carácter del búfer de entrada de SerialPort.

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

Devoluciones

Int32

El carácter leído.

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 estaba disponible ningún carácter en el período del tiempo de espera asignado.

Comentarios

Este método lee un carácter completo basado en la codificación.

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 manualmente bytes y descodificar los datos.

Nota

Dado que la SerialPort clase almacena en búfer los 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