SerialPort.ReadExisting 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 tous les octets immédiatement disponibles, en fonction de l'encodage, dans le flux et dans la mémoire tampon d'entrée de l'objet SerialPort.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Retours

String

Contenu du flux et de la mémoire tampon d'entrée de l'objet SerialPort.

Exceptions

InvalidOperationException

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

Remarques

Cette méthode retourne le contenu du flux et de la mémoire tampon interne de l’objet SerialPort sous forme de chaîne. Cette méthode n’utilise pas de délai d’attente. Notez que cette méthode peut laisser des octets de prospect de fin dans la mémoire tampon interne, ce qui rend la BytesToRead valeur supérieure à zéro.

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 les données texte et binaires, par exemple la lecture manuelle des octets et le décodage des données.

Notes

La SerialPort classe met en mémoire tampon les données, mais pas l’objet stream contenu dans la SerialPort.BaseStream propriété. Par conséquent, l’objet SerialPort et l’objet stream peuvent différer sur le nombre d’octets disponibles en lecture. Lorsque des octets sont mis en mémoire tampon dans l’objet SerialPort , la BytesToRead propriété inclut ces octets dans sa valeur ; toutefois, ces octets peuvent ne pas être accessibles au flux contenu dans la BaseStream propriété.