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

File

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

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

LastError

File.LastError

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

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

ReadContents

File.ReadContents(filePath)

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

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

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

WriteContents

File.WriteContents(filePath, contents)

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

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

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

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

ReadLine

File.ReadLine(filePath, lineNumber)

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

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

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

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

WriteLine

File.WriteLine(filePath, lineNumber, contents)

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

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

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

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

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

InsertLine

File.InsertLine(filePath, lineNumber, contents)

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

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

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

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

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

AppendContents

File.AppendContents(filePath, contents)

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

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

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

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

CopyFile

File.CopyFile(sourceFilePath, destinationFilePath)

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

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

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

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

DeleteFile

File.DeleteFile(filePath)

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

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

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

CreateDirectory

File.CreateDirectory(directoryPath)

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

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

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

DeleteDirectory

File.DeleteDirectory(directoryPath)

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

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

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

GetFiles

File.GetFiles(directoryPath)

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

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

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

GetDirectories

File.GetDirectories(directoryPath)

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

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

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

GetTemporaryFilePath

File.GetTemporaryFilePath()

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

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

GetSettingsFilePath

File.GetSettingsFilePath()

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

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

Поделиться: