SerialPort.ReadExisting 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 todos los bytes inmediatamente disponibles, basándose en la codificación, en la secuencia y el búfer de entrada del objeto SerialPort.

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

Devoluciones

String

El contenido de la secuencia y del búfer de entrada del objeto SerialPort.

Excepciones

InvalidOperationException

El puerto especificado no está abierto.

Comentarios

Este método devuelve el contenido de la secuencia y el búfer interno del SerialPort objeto como una cadena. Este método no usa un tiempo de espera. Tenga en cuenta que este método puede dejar bytes de cliente potencial finales en el búfer interno, lo que hace que el BytesToRead valor sea mayor que cero.

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

La SerialPort clase almacena en búfer los datos, pero el objeto de secuencia contenido en la SerialPort.BaseStream propiedad no. Por lo tanto, el SerialPort objeto y el objeto stream pueden diferir en el número de bytes que están disponibles para leerse. Cuando los bytes se almacenan en búfer en el SerialPort objeto, la BytesToRead propiedad incluye estos bytes en su valor; sin embargo, es posible que estos bytes no sean accesibles para la secuencia contenida en la BaseStream propiedad .