SerialPort.ReadTo(String) Метод

Определение

Пространство имен:

System.IO.Ports

Сборка:

System.IO.Ports.dll

Пакет:

System.IO.Ports v8.0.0

Исходный код:

SerialPort.cs

Считывает из входного буфера строку до указанного значения value.

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

Параметры

value

String

Значение, указывающее место прекращения операции чтения.

Возвращаемое значение

String

Содержимое входного буфера до указанного value.

Исключения

ArgumentException

Длина параметра value равна 0.

ArgumentNullException

Параметр value имеет значение null.

InvalidOperationException

Указанный порт не открыт.

TimeoutException

Операция не была завершена до истечения срока ожидания.

Комментарии

Этот метод считывает строку до указанного value. Хотя возвращаемая строка не содержит value, value объект удаляется из входного буфера.

Если необходимо переключаться между чтением текста и двоичными данными из потока, выберите протокол, который тщательно определяет границу между текстовыми и двоичными данными, например чтение байтов вручную и декодирование данных.

Примечание

SerialPort Так как класс буферизует данные, а поток, содержащийся в BaseStream свойстве, нет, они могут конфликтовать о том, сколько байтов доступно для чтения. Свойство BytesToRead может указывать на то, что есть байты для чтения, но эти байты могут быть недоступны для потока, содержащегося в свойстве BaseStream , так как они были помещены в буфер в SerialPort класс .