• Если отладка — процесс удаления ошибок, то программирование — процесс их создания.

Класс File (Файл)

http://smallbasic.com/smallbasic.com/img/object_32.pngFile

Класс File (Файл) предоставляет методы для доступа к данным, чтения из файлов, записи данных в файлы и другим файловым операциям. С помощью этого объекта настройки вашей программы могут быть сохранены перед завершением работы программы и загружены при следующем запуске.

Свойства класса File:

http://smallbasic.com/smallbasic.com/img/property_16.pngLastError

File.LastError

Получает или устанавливает сообщение о последней ошибке, случившейся при операциях с файлами. Это свойство полезно при выяснении причин сбоя какого-либо метода класса.

Методы класса File:

http://smallbasic.com/smallbasic.com/img/method_16.pngReadContents

File.ReadContents(filePath)

Открывает файл и считывает все его содержимое. Этот метод будет работать быстро для файлов размером меньше 1 МБ, но будет работать заметно медленнее на файлах больше 10 МБ.

filePath — Полный путь к файлу, который нужно прочитать. Например: «c:\temp\settings.data».

Возвращает: Содержимое файла.

http://smallbasic.com/smallbasic.com/img/method_16.pngWriteContents

File.WriteContents(filePath, contents)

Открывает файл и записывает в него указанную информацию с заменой исходной информации в файле.

filePath — Полный путь к файлу, в который нужно записать данные. Например, полный путь может выглядеть так: «c:\temp\settings.data».

contents — Информация для записи в файл.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngReadLine

File.ReadLine(filePath, lineNumber)

Открывает указанный файл и считывает из файла строку с указанным номером.

filePath — Полный путь к файлу, из которого нужно прочитать данные. Например, полный путь может выглядеть так: «c:\temp\settings.data».

lineNumber — Номер строки, которая будет считана.

Возвращает: Текстовую строку, считанную из указанного файла.

http://smallbasic.com/smallbasic.com/img/method_16.pngWriteLine

File.WriteLine(filePath, lineNumber, contents)

Открывает указанный файл и записывает информацию в строку с указанным номером. Эта операция перезаписывает информацию, если она уже находится в файле в строке с указанным номером.

filePath — Полный путь к файлу, который нужно прочитать. Например, полный путь может выглядеть так: «c:\temp\settings.data».

lineNumber — Номер строки, в которой будет записан текст.

contents — Текст, который будет записан в указанную строку в файле.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngInsertLine

File.InsertLine(filePath, lineNumber, contents)

Открывает указанный файл и вставляет информацию в строку с указанным номером, сдвигая следующие строки. Эта операция не перезаписывает существующую информацию в файле, а добавляет ее в строку с указанным номером.

filePath — Полный путь к файлу, из которого нужно прочитать данные. Например, полный путь может выглядеть так: «c:\temp\settings.data».

lineNumber — Номер строки, по которому надо вставить текст.

contents — Информация, которую надо вставить в файл.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngAppendContents

File.AppendContents(filePath, contents)

Открывает указанный файл и добавляет информацию в конец файла.

filePath — Полный путь к файлу, из которого нужно прочитать данные. Например, полный путь может выглядеть так: «c:\temp\settings.data».

contents — Текст, который будет добавлен в конец файла.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngCopyFile

File.CopyFile(sourceFilePath, destinationFilePath)

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

sourceFilePath — Полный путь к файлу, который нужно скопировать. Например, полный путь может выглядеть так: «c:\temp\settings.data».

destinationFilePath — Путь, по которому надо скопировать файл.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngDeleteFile

File.DeleteFile(filePath)

Удаляет указанный файл.

filePath — Путь к конечному месту расположения файла. Например, полный путь может выглядеть так: «c:\temp\settings.data».

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngCreateDirectory

File.CreateDirectory(directoryPath)

Создает указанную папку.

directoryPath — Полный путь к папке, которую надо создать.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngDeleteDirectory

File.DeleteDirectory(directoryPath)

Удаляет указанную папку.

directoryPath — Полный путь к каталогу, который должен быть удален.

Возвращает: В случае успешного выполнения операции возвращает «SUCCESS». В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngGetFiles

File.GetFiles(directoryPath)

Получает пути всех файлов в указанной папке.

directoryPath — Папка для поиска файлов.

Возвращает: В случае успешного выполнения операция возвращает список файлов в виде массива. В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngGetDirectories

File.GetDirectories(directoryPath)

Получает пути всех папок в указанной папке.

directoryPath — Папка для поиска вложенных папок.

Возвращает: В случае успешного выполнения операция возвращает список папок в виде массива. В противном случае возвращает «FAILED».

http://smallbasic.com/smallbasic.com/img/method_16.pngGetTemporaryFilePath

File.GetTemporaryFilePath()

Создает новый временный файл во временной папке и возвращает полный путь к файлу.

Возвращает: Полный путь к временному файлу.

http://smallbasic.com/smallbasic.com/img/method_16.pngGetSettingsFilePath

File.GetSettingsFilePath()

Получает полный путь к файлу настроек для данной программы. Имя файла настроек программы формируется на основании имени программы и располагается в том же каталоге, что и сама программа.

Возвращает: Полный путь к файлу настроек для текущего приложения.


Поделиться: