SerialPort.ReadByte Méthode

Définition

Espace de noms:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paquet:

System.IO.Ports v8.0.0

Source:

SerialPort.cs

Lit de façon synchrone un octet de la mémoire tampon d'entrée SerialPort.

public:
 int ReadByte();

public int ReadByte ();

member this.ReadByte : unit -> int

Public Function ReadByte () As Integer

Retours

Int32

Octet, converti en type (transtypage) Int32, ou -1 si la fin du flux a été lue.

Exceptions

InvalidOperationException

Le port spécifié n'est pas ouvert.

TimeoutException

L'opération ne s'est pas terminée avant la fin du délai d'attente.

- ou -

Aucun octet n'a été lu.

Remarques

Cette méthode lit un octet.

Soyez prudent lorsque vous utilisez ReadByte et ReadChar ensemble. Le basculement entre les octets de lecture et les caractères de lecture peut entraîner la lecture de données supplémentaires et/ou d’autres comportements involontaires. S’il est nécessaire de basculer entre la lecture de texte et la lecture de données binaires à partir du flux, sélectionnez un protocole qui définit soigneusement la limite entre le texte et les données binaires, comme la lecture manuelle des octets et le décodage des données.

Notes

Étant donné que la SerialPort classe met en mémoire tampon les données et que le flux contenu dans la propriété ne le BaseStream fait pas, les deux peuvent être en conflit quant au nombre d’octets disponibles pour la lecture. La BytesToRead propriété peut indiquer qu’il existe des octets à lire, mais ces octets peuvent ne pas être accessibles au flux contenu dans la BaseStream propriété, car ils ont été mis en mémoire tampon dans la SerialPort classe .