Метод ReadText

Считывает указанное количество символов из текстового объекта Stream .

Синтаксис

  
String = Stream.ReadText ( NumChars)  

Параметры

NumChars
Необязательный элемент. Значение Типа Long , указывающее количество символов, считываемых из файла, или значение StreamReadEnum . Значение по умолчанию — adReadAll.

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

Метод ReadText считывает указанное количество символов, всю строку или весь поток из объекта Stream и возвращает результирующую строку.

Комментарии

Если значение NumChar превышает число символов, оставшихся в потоке, возвращаются только оставшиеся символы. Прочитанная строка не заполняется в соответствии с длиной, указанной в NumChar. Если для чтения не осталось символов, возвращается вариант со значением NULL. ReadText нельзя использовать для чтения в обратном направлении.

Примечание

Метод ReadText используется с текстовыми потоками (тип — adTypeText). Для двоичных потоков (тип— adTypeBinary) используйте read.

Выполнение запросов, которые приводят к возврату большого объема XML-данных с помощью метода ReadText объекта Объекта данных ActiveX (ADO) Stream, может занять много времени; Если это делается в компоненте COM+, который вызывается с ASP-страницы, сеанс пользователя может и завершиться. ADO преобразует данные объекта Stream из кодировки UTF-8 в Юникод; частое перераспределение памяти, связанное с преобразованием такого большого количества данных одновременно, занимает довольно много времени. Чтобы устранить проблему, выполните повторяющиеся вызовы метода ReadText объекта команды ADO и укажите меньшее количество символов. Тесты показали, что оптимальное значение, эквивалентное 128 КБ (131 072). Время отклика уменьшается по мере уменьшения этого значения. Дополнительные сведения см. в статье базы знаний 280067 "PRB: извлечение очень больших XML-документов из SQL Server 2000 с помощью метода ReadText объекта потока ADO может быть медленным" в базе знаний Майкрософт по адресу https://support.microsoft.com.

Применение

Объект Stream (ADO)

См. также:

Метод Read