SerialPort.ReadExisting Methode

Definition

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Quelle:

SerialPort.cs

Liest alle sofort verfügbaren Bytes auf Grundlage der Codierung sowohl im Stream als auch im Eingabepuffer des SerialPort-Objekts.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Gibt zurück

String

Der Inhalt des Streams und des Eingabepuffers des SerialPort-Objekts.

Ausnahmen

InvalidOperationException

Der angegebene Anschluss ist nicht offen.

Hinweise

Diese Methode gibt den Inhalt des Datenstroms und des internen Puffers des SerialPort Objekts als Zeichenfolge zurück. Diese Methode verwendet kein Timeout. Beachten Sie, dass diese Methode nachfolgende Leadbytes im internen Puffer belassen kann, wodurch der BytesToRead Wert größer als 0 (null) ist.

Wenn zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Datenstrom gewechselt werden muss, wählen Sie ein Protokoll aus, das die Grenze zwischen Text- und Binärdaten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodieren der Daten.

Hinweis

Die SerialPort -Klasse puffert Daten, das in der SerialPort.BaseStream -Eigenschaft enthaltene Streamobjekt hingegen nicht. Daher können sich das SerialPort Objekt und das Streamobjekt hinsichtlich der Anzahl der Bytes unterscheiden, die zum Lesen verfügbar sind. Wenn Bytes für das SerialPort -Objekt gepuffert werden, schließt die BytesToRead Eigenschaft diese Bytes in ihren Wert ein. Auf diese Bytes kann jedoch möglicherweise nicht für den in der BaseStream -Eigenschaft enthaltenen Stream zugegriffen werden.