Idioma

SerialPort.ReadByte Método

Definição

Lê síncronicamente um byte do SerialPort buffer de entrada.

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

Devoluções

O byte, cast para um Int32, ou -1 se o fim do fluxo tiver sido lido.

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-

Nenhum byte foi lido.

Observações

Este método lê um byte.

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