FileSystem.InputString(Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение String
, содержащее знаки из файла, открытого в режиме Input
или Binary
. Функция My
обеспечивает более высокие показатели производительности и быстродействия в операциях файлового ввода-вывода в сравнении с InputString
. Для получения дополнительной информации см. FileSystem.
public:
static System::String ^ InputString(int FileNumber, int CharCount);
public static string InputString (int FileNumber, int CharCount);
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("macos")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static string InputString (int FileNumber, int CharCount);
static member InputString : int * int -> string
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("macos")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member InputString : int * int -> string
Public Function InputString (FileNumber As Integer, CharCount As Integer) As String
Параметры
- FileNumber
- Int32
Обязательный. Любой допустимый номер файла.
- CharCount
- Int32
Обязательный. Любое допустимое числовое выражение, указывающее число знаков, которые надо прочитать.
Возвращаемое значение
Строка, содержащая знаки из файла, открытого в режиме Input
или Binary
. Функция My
обеспечивает более высокие показатели производительности и быстродействия в операциях файлового ввода-вывода в сравнении с InputString
.
- Атрибуты
Исключения
FileNumber
— не существует.
CharCount
< 0 или > 214.
Примеры
В этом примере функция используется 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)
Комментарии
Функция InputString
предоставляется для обеспечения обратной совместимости и может повлиять на производительность. Для приложений, не являющихся My.Computer.FileSystem
устаревшими, объект обеспечивает более высокую производительность. Дополнительные сведения см. в статье Доступ к файлам с помощью Visual Basic.
Данные, считываемые с помощью InputString
функции , обычно записываются в файл с помощью Print
или FilePut
. Используйте эту функцию только с файлами, открытыми в Input
режиме или Binary
.
Input
В отличие от функции, InputString
функция возвращает все считыванные символы. Сюда входят запятые, возврат каретки, каналы строк, кавычки и пробелы в начале.
Если файлы открыты для Binary
доступа, попытка прочитать файл с помощью InputString
функции до возврата EOF
True
приведет к ошибке. LOF
Используйте функции и Loc
вместо при чтении двоичных EOF
файлов с помощью InputString
или при FileGet
использовании EOF
функции .
Примечание
При чтении из файлов не следует принимать решения о безопасности содержимого файла на основе расширения имени файла. Например, файл с именем Form1.vb может не быть исходным файлом Visual Basic.