SerialPort.ReadChar Méthode

Définition

Espace de noms:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Assembly:

System.dll

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.

Utilisez la prudence lors de l’utilisation et ReadChar de l’ensembleReadByte. Le basculement entre les octets de lecture et les caractères de lecture peut entraîner la lecture et/ou un autre comportement inattendu. 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, telles que 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 entrer en conflit sur le 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.