SerialPort.ReadChar Método

Definição

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacote:

System.IO.Ports v8.0.0

Origem:

SerialPort.cs

Lê um caractere do buffer de entrada SerialPort de maneira síncrona.

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

Retornos

Int32

O caractere que foi lido.

Exceções

InvalidOperationException

A porta especificada não está aberta.

TimeoutException

A operação não foi concluída antes do encerramento do tempo limite.

- ou -

Nenhum caractere estava disponível no período de tempo limite alocado.

Comentários

Esse método lê um caractere completo com base na codificação.

Tenha cuidado ao usar ReadByte e ReadChar juntos. Alternar entre bytes de leitura e caracteres de leitura pode fazer com que dados extras sejam lidos e/ou outro comportamento não intencional. Se for necessário alternar entre a leitura de texto e a leitura de dados binários do fluxo, selecione um protocolo que defina cuidadosamente o limite entre o texto e os dados binários, como ler manualmente bytes e decodificar os dados.

Observação

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