Функция InputString
Обновлен: Ноябрь 2007
Возвращает значение String, содержащее символы из файла, открытого в режиме Input или Binary.
Функция My обеспечивает более высокую производительность и быстродействие операций ввода и вывода, чем InputString. Дополнительные сведения см. в разделе Объект My.Computer.FileSystem.
InputString(_
ByVal FileNumber As Integer, _
ByVal CharCount As Integer _
) As String
Параметры
FileNumber
Обязательный параметр. Любой допустимый номер файла.CharCount
Обязательный параметр. Любое допустимое числовое выражение, указывающее число символов, которые надо прочитать.
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
FileNumber не существует. |
||
CharCount < 0 или > 214. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако, по возможности, следует заменять такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Функция InputString предназначена для обеспечения обратной совместимости и может оказать влияние на производительность. Для новых приложений объект My.Computer.FileSystem обеспечивает более высокую производительность. Дополнительные сведения см. в разделе Доступ к файлам с помощью Visual Basic.
Данные, считываемые функцией InputString, обычно записывают в файл при помощи Print или FilePut. Эту функцию следует использовать только для файлов, открытых в режиме Input или Binary.
В отличие от функции Input функция InputString возвращает все прочитанные ею знаки, включая запятые, знаки перевода строки, символы новой строки, кавычки и пробелы в начале строки.
В файлах, открытых для Binary доступа, попытка прочитать файл с помощью функции InputString, когда EOF возвращает True, приведет к ошибке. При чтении двоичных файлов с помощью функции InputString следует использовать вместо EOF функции LOF и Loc или вместе c функцией EOF следует использовать FileGet.
.gif "Примечание о безопасности") Примечание о безопасности. |
|---|
При считывании из файла не следует судить о его содержимом только по его расширению. Например, файл с именем Form1.vb может не являться исходным файлом Visual Basic. |
Пример
В этом примере функция InputString используется для последовательного чтения символов из файла и их вывода в окне Output. В этом примере предполагается, что MyFile представляет собой текстовый файл, состоящий из нескольких строк образцов данных.
Dim oneChar As String
' Open file.
FileOpen(1, "MYFILE.TXT", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
' Get one character.
oneChar = (InputString(1, 1))
' Print to the output window.
System.Console.Out.WriteLine(oneChar)
End While
FileClose(1)
Примечания для разработчиков приложений для интеллектуальных устройств
Данная функция не поддерживается.
Требования
Пространство имен: Microsoft.VisualBasic
**Модуль:**FileSystem
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)
См. также
Задачи
Практическое руководство. Запись текста в файлы с помощью StreamWriter в Visual Basic
Практическое руководство. Запись текста в файлы в Visual Basic