SerialPort.ReadChar 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 carattere dal buffer di input SerialPort.

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

Restituisce

Int32

Carattere letto.

Eccezioni

InvalidOperationException

La porta specificata non è aperta.

TimeoutException

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

-oppure-

Nessun carattere disponibile nel periodo di timeout specificato.

Commenti

Questo metodo legge un carattere completo in base alla codifica.

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 .