SerialPort.ReadByte 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 Byte aus dem SerialPort Eingabepuffer.
public:
int ReadByte();
public int ReadByte();
member this.ReadByte : unit -> int
Public Function ReadByte () As Integer
Gibt zurück
Das Byte, wird in ein Int32oder -1, wenn das Ende des Datenstroms gelesen wurde.
Ausnahmen
Der angegebene Port ist nicht geöffnet.
Der Vorgang wurde vor Ablauf des Timeoutzeitraums nicht abgeschlossen.
- oder -
Es wurde kein Byte gelesen.
Hinweise
Diese Methode liest ein Byte.
Achten Sie bei der Verwendung ReadByte und ReadChar zusammenarbeiten Sie auf Vorsicht. Der Wechsel zwischen Lesebytes und Lesezeichen kann dazu führen, dass zusätzliche Daten gelesen und/oder ein anderes unbeabsichtigtes Verhalten angezeigt werden. Wenn es erforderlich ist, zwischen dem Lesen von Text und dem Lesen von Binärdaten aus dem Datenstrom zu wechseln, wählen Sie ein Protokoll aus, das die Grenze zwischen Text und Binären Daten sorgfältig definiert, z. B. manuelles Lesen von Bytes und Decodieren der Daten.
Hinweis
Da die SerialPort Klassendaten und der in der BaseStream Eigenschaft enthaltene Datenstrom nicht gepuffert werden, stehen möglicherweise Konflikte zwischen den beiden Bytes zum Lesen zur Verfügung. Die BytesToRead Eigenschaft kann angeben, dass Bytes gelesen werden sollen, aber auf diese Bytes kann möglicherweise nicht auf den in der BaseStream Eigenschaft enthaltenen Datenstrom zugegriffen werden, da sie in der SerialPort Klasse gepuffert wurden.