SerialPort.ReadTo(String) Metodo

Definizione

Spazio dei nomi:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacchetto:

System.IO.Ports v8.0.0

Origine:

SerialPort.cs

Legge una stringa fino al parametro value specificato nel buffer di input.

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

Parametri

value

String

Valore che indica dove termina l'operazione di lettura.

Restituisce

String

Contenuto del buffer di input fino al parametro value specificato.

Eccezioni

ArgumentException

La lunghezza del parametro value è 0.

ArgumentNullException

Il valore del parametro value è null.

InvalidOperationException

La porta specificata non è aperta.

TimeoutException

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

Commenti

Questo metodo legge una stringa fino all'oggetto specificato value. Mentre la stringa restituita non include value, l'oggetto value viene rimosso dal buffer di input.

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 .