SerialPort.ReadExisting Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> stringPublic Function ReadExisting () As StringGibt zurück
Der Inhalt des Streams und des Eingabepuffers des SerialPort-Objekts.
Ausnahmen
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 lassen kann, wodurch der BytesToRead Wert größer als 0 ist.
Wenn zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Stream 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 jedoch 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. Möglicherweise sind diese Bytes jedoch nicht für den in der BaseStream -Eigenschaft enthaltenen Stream zugänglich.
