Freigeben über


SerialPort.ReadByte Methode

Definition

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.

Gilt für: