SerialPort.ReadExisting Metodo

Definizione

Spazio dei nomi:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacchetto:

System.IO.Ports v8.0.0

Origine:

SerialPort.cs

Legge tutti i byte disponibili immediatamente, in base alla codifica, sia nel flusso che nel buffer di input dell'oggetto SerialPort.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Restituisce

String

Contenuto del flusso e del buffer di input dell'oggetto SerialPort.

Eccezioni

InvalidOperationException

La porta specificata non è aperta.

Commenti

Questo metodo restituisce il contenuto del flusso e del buffer interno dell'oggetto SerialPort come stringa. Questo metodo non usa un timeout. Si noti che questo metodo può lasciare i byte finali del lead nel buffer interno, che rende il BytesToRead valore maggiore di zero.

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

La SerialPort classe memorizza nel buffer i dati, ma l'oggetto flusso contenuto nella SerialPort.BaseStream proprietà non lo fa. Pertanto, l'oggetto e l'oggetto SerialPort flusso possono variare in base al numero di byte disponibili per la lettura. Quando i byte vengono memorizzati nel buffer nell'oggetto SerialPort , la BytesToRead proprietà include questi byte nel relativo valore, ma questi byte potrebbero non essere accessibili al flusso contenuto nella BaseStream proprietà .