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 -> int
Public Function ReadChar () As Integer
Gibt 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 basierend auf der Codierung ein vollständiges Zeichen.
Gehen Sie vorsichtig vor, wenn Sie und ReadChar zusammen verwendenReadByte. Der Wechsel zwischen dem Lesen von Bytes und dem Lesen von Zeichen kann dazu führen, dass zusätzliche Daten gelesen werden und/oder ein anderes unbeabsichtigtes Verhalten auftritt. 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
Da die SerialPort -Klasse Daten puffert und der in der BaseStream -Eigenschaft enthaltene Stream nicht, können die beiden in Konflikt stehen, wie viele Bytes zum Lesen verfügbar sind. Die BytesToRead -Eigenschaft kann angeben, dass Zu lesende Bytes vorhanden sind, aber diese Bytes sind möglicherweise nicht für den in der BaseStream -Eigenschaft enthaltenen Stream zugänglich, da sie in der SerialPort -Klasse gepuffert wurden.