Condividi tramite


SerialPort.ReadByte Metodo

Definizione

Legge in modo sincrono un byte dal buffer di input SerialPort.

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

Restituisce

Byte, cast su un oggetto Int32 o -1 se è stata letta la fine del flusso.

Eccezioni

La porta specificata non è aperta.

L'operazione non è stata completata prima dello scadere del periodo di timeout.

-oppure-

Non sono stati letti byte.

Commenti

Questo metodo legge un byte.

Prestare attenzione quando si usano ReadByte e ReadChar insieme. Il passaggio tra byte di lettura e caratteri di lettura può causare la lettura di dati aggiuntivi e/o altri comportamenti imprevisti. Se è necessario passare dalla lettura del testo alla lettura dei dati binari dal flusso, selezionare un protocollo che definisce attentamente il limite tra dati di testo e binari, ad esempio la lettura manuale dei byte e la decodifica dei dati.

Nota

Poiché la classe memorizza nel SerialPort buffer i dati e il flusso contenuto nella BaseStream proprietà non lo fa, i due potrebbero essere in conflitto sul numero di byte disponibili per la lettura. La BytesToRead proprietà può indicare che sono presenti byte da leggere, ma questi byte potrebbero non essere accessibili al flusso contenuto nella proprietà perché sono stati memorizzati nel BaseStream buffer nella SerialPort classe .

Si applica a