SerialPort.ReadChar 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 caractère de la mémoire tampon d’entrée SerialPort.

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

Retours

Int32

Caractère qui a été lu.

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 caractère n'était disponible dans le délai d'attente imparti.

Remarques

Cette méthode lit un caractère complet en fonction de l’encodage.

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 .