Поделиться через


SerialPort.ReadTo(String) Метод

Определение

Считывает из входного буфера строку до указанного значения 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

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

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

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

Исключения

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

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

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

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

Комментарии

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

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

Примечание

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

Применяется к