File

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

Properties

LastError

File.LastError

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

Operations

ReadContents

File.ReadContents(filePath)

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

filePath

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

Returns

Содержимое файла.

WriteContents

File.WriteContents(filePath, contents)

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

filePath

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

contents

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

Returns

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

ReadLine

File.ReadLine(filePath, lineNumber)

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

filePath

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

lineNumber

Номер строки, с которой начнется чтение текста.

Returns

Текст из указанного файла, начиная с указанной строки.

WriteLine

File.WriteLine(filePath, lineNumber, contents)

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

filePath

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

lineNumber

Номер строки, с которой начнется запись текста.

contents

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

Returns

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

InsertLine

File.InsertLine(filePath, lineNumber, contents)

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

filePath

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

lineNumber

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

contents

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

Returns

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

AppendContents

File.AppendContents(filePath, contents)

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

filePath

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

contents

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

Returns

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

CopyFile

File.CopyFile(sourceFilePath, destinationFilePath)

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

sourceFilePath

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

destinationFilePath

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

Returns

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

DeleteFile

File.DeleteFile(filePath)

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

filePath

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

Returns

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

CreateDirectory

File.CreateDirectory(directoryPath)

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

directoryPath

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

Returns

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

DeleteDirectory

File.DeleteDirectory(directoryPath)

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

directoryPath

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

Returns

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

GetFiles

File.GetFiles(directoryPath)

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

directoryPath

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

Returns

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

GetDirectories

File.GetDirectories(directoryPath)

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

directoryPath

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

Returns

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

GetTemporaryFilePath

File.GetTemporaryFilePath()

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

Returns

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

GetSettingsFilePath

File.GetSettingsFilePath()

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

Returns

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