Idioma

SerialPort.ReadChar Método

Definição

Lê sincronizadamente um carácter do SerialPort buffer de entrada.

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

Devoluções

A personagem que foi lida.

Exceções

A porta especificada não está aberta.

A operação não foi concluída antes do término do período de pausa.

-ou-

Nenhuma personagem estava disponível no período de tempo estipulado.

Observações

Este método lê um carácter completo com base na codificação.

Tenha cautela ao usar ReadByte e ReadChar ao usar em conjunto. Alternar entre bytes de leitura e caracteres de leitura pode causar leitura de dados extra e/ou outros comportamentos não intencionais. Se for necessário alternar entre ler texto e ler dados binários do fluxo, selecione um protocolo que defina cuidadosamente a fronteira entre o texto e os dados binários, como ler manualmente bytes e decodificar os dados.

Note

Como a SerialPort classe armazena os dados, e o fluxo contido na BaseStream propriedade não, os dois podem entrar em conflito sobre quantos bytes estão disponíveis para leitura. A BytesToRead propriedade pode indicar que existem bytes para ler, mas esses bytes podem não ser acessíveis ao fluxo contido na BaseStream propriedade porque foram armazenados na SerialPort classe.

Aplica-se a