SerialPort.ReadByte Metodo

Definizione

Spazio dei nomi:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacchetto:

System.IO.Ports v8.0.0

Origine:

SerialPort.cs

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

Int32

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

Eccezioni

InvalidOperationException

La porta specificata non è aperta.

TimeoutException

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 .