SerialPort.ReadTo(String) Método

Definición

Espacio de nombres:

System.IO.Ports

Ensamblado:

System.IO.Ports.dll

Paquete:

System.IO.Ports v8.0.0

Source:

SerialPort.cs

Lee una cadena hasta el value especificado en el búfer de entrada.

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

Parámetros

value

String

Valor que indica dónde se detiene la operación de lectura.

Devoluciones

String

El contenido del búfer de entrada hasta el valor de value especificado.

Excepciones

ArgumentException

La longitud del parámetro value es 0.

ArgumentNullException

El parámetro value es null.

InvalidOperationException

El puerto especificado no está abierto.

TimeoutException

La operación no se ha terminado antes de que transcurriera el tiempo de espera.

Comentarios

Este método lee una cadena hasta el especificado value. Aunque la cadena devuelta no incluye value, value se quita del búfer de entrada.

Si es necesario cambiar entre leer texto y leer datos binarios de la secuencia, seleccione un protocolo que defina cuidadosamente el límite entre texto y datos binarios, como leer manualmente bytes y descodificar los datos.

Nota

Dado que la SerialPort clase almacena en búfer los datos y la secuencia contenida en la BaseStream propiedad no, los dos podrían entrar en conflicto sobre cuántos bytes están disponibles para leerse. La BytesToRead propiedad puede indicar que hay bytes para leer, pero es posible que estos bytes no sean accesibles para la secuencia contenida en la BaseStream propiedad porque se han almacenado en búfer en la SerialPort clase .