Функция Input
Обновлен: Ноябрь 2007
Считывает данные из открытого последовательного файла и присваивает их переменным.
Public Sub Input( _
FileNumber As Integer, _
ByRef Value As Object _
)
Параметры
FileNumber
Обязательно. Любой допустимый номер файла.Value
Обязательно. Переменная, которой присваиваются значения, считанные из файла. Она не может быть массивом или объектной переменной.
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
FileNumber не существует. |
||
Недопустимый режим файла. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err)). Однако по возможности следует заменить такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Функция Input предназначена для обеспечения обратной совместимости и может оказать влияние на производительность. Для неустаревших версий приложений объект My.Computer.FileSystem предоставляет более высокую производительность. Дополнительные сведения см. в разделе Доступ к файлам с помощью Visual Basic.
Данные, считанные с помощью функции Input, обычно записываются в файл, используяWrite. Эту функцию следует использовать только для файлов, открытых в режиме Input или Binary.
.gif "Примечание о безопасности") Примечание о безопасности. |
|---|
При считывании из файла не следует судить о его содержимом только по его расширению. Например, файл с именем Form1.vb может не являться исходным файлом Visual Basic. |
При считывании стандартные строковые или числовые данные присваиваются переменным без изменения. В приведенной ниже таблице показано, как обрабатываются входные данные других типов.
Данные |
Значение, присваиваемое переменной |
|---|---|
Разделяющая запятая или пустая строка |
Пусто |
#NULL# |
DBNull |
#TRUE# или #FALSE# |
True или False |
#yyyy-mm-ddhh:mm:ss# |
Дата и/или время, представленные выражением |
#ERROR errornumber# |
errornumber (переменная является объектом, помеченным как ошибка) |
Если при чтении элемента данных достигнут конец файла, чтение прекращается и выдается сообщение об ошибке.
.gif "Примечание") Примечание. |
|---|
Функция Input не локализована. Например, в немецкой версии, если записано 3,14159, будет получено значение 3, т. к. запятая рассматривается как разделитель переменных, а не как десятичный разделитель. |
| Примечание о безопасности. |
|---|
Чтение файла с помощью функции Input требует доступ Read из перечисления FileIOPermissionAccess. Дополнительные сведения содержатся в разделе FileIOPermissionAccess Enumeration. |
Пример
В этом примере функция Input используется для считывания данных из файла в две переменных. В этом примере TestFile — файл с несколькими строками данных, записанный с помощью функции Write, каждая строка содержит текст в кавычках и номер, разделенные запятой (например, "Здравствуйте", 234).
FileOpen(1, "TESTFILE", OpenMode.Output)
Write(1, "hello")
Write(1, 14)
FileClose(1)
Dim s As String = "teststring"
Dim i As Integer
FileOpen(1, "TESTFILE", OpenMode.Input)
Input(1, s)
MsgBox(s)
Input(1, i)
MsgBox(i)
FileClose(1)
Примечания для разработчиков приложений для интеллектуальных устройств
Данная функция не поддерживается.
Требования
Пространство имен: Microsoft.VisualBasic
**Модуль:**FileSystem
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)
См. также
Задачи
Практическое руководство. Запись текста в файлы в Visual Basic
Практическое руководство. Запись текста в файлы с помощью StreamWriter в Visual Basic