Partilhar via


SerialPort.ReadByte Método

Definição

Lê um byte do buffer de entrada SerialPort sincronicamente.

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

Retornos

O byte, convertido em um Int32, ou -1 se o final do fluxo foi lido.

Exceções

A porta especificada não está aberta.

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

- ou -

Nenhum byte foi lido.

Comentários

Esse método lê um byte.

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 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 o limite entre texto e 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 ao fluxo contido na propriedade porque foram armazenados em BaseStream buffer para a SerialPort classe .

Aplica-se a