SerialPort.ReadTo(String) 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 une chaîne jusqu'à la valeur value spécifiée dans la mémoire tampon d'entrée.

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

Paramètres

value

String

Valeur qui indique où l'opération de lecture s'arrête.

Retours

String

Contenu de la mémoire tampon d'entrée jusqu'à l'élément value spécifié.

Exceptions

ArgumentException

La longueur du paramètre value est égale à 0.

ArgumentNullException

Le paramètre value a la valeur null.

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.

Remarques

Cette méthode lit une chaîne jusqu’au spécifié value. Bien que la chaîne retournée n’inclut pas , valueest value supprimé de la mémoire tampon d’entrée.

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 .