SerialPort.ReadChar 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 synchron ein Zeichen aus dem SerialPort-Eingabepuffer.
public:
int ReadChar();public int ReadChar ();member this.ReadChar : unit -> intPublic Function ReadChar () As IntegerGibt zurück
Das Zeichen, das gelesen wurde.
Ausnahmen
Der angegebene Anschluss ist nicht offen.
Der Vorgang konnte nicht vor Ablauf des Timeouts abgeschlossen werden.
- oder -
Im zugewiesenen Timeoutzeitraum war kein Zeichen verfügbar.
Hinweise
Diese Methode liest ein vollständiges Zeichen basierend auf der Codierung.
Verwenden Sie Vorsicht bei der Verwendung ReadByte und ReadChar zusammen. Das Wechseln zwischen Lesebytes und Lesezeichen kann dazu führen, dass zusätzliche Daten gelesen und/oder ein anderes unbeabsichtigtes Verhalten angezeigt werden. Wenn es notwendig ist, zwischen Lesetext und Lese binärdaten aus dem Datenstrom zu wechseln, wählen Sie ein Protokoll aus, das die Grenze zwischen Text und Binärdaten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodierung der Daten.
Hinweis
Da die SerialPort Klassenpuffer daten und der Datenstrom, der in der BaseStream Eigenschaft enthalten ist, nicht enthalten ist, kann die beiden konflikten, wie viele Bytes zum Lesen verfügbar sind. Die BytesToRead Eigenschaft kann darauf hinweisen, dass Bytes gelesen werden, aber diese Bytes können möglicherweise nicht auf den datenstrom zugreifen, der in der BaseStream Eigenschaft enthalten ist, da sie an die SerialPort Klasse gepuffert wurden.