Structr
Search
⌃K

FileHelper

FileHelper class provides synchronous and asynchronous methods for the write, read and delete a single file.

SaveFile()

Synchronously saves a byte array to a file by an absolute path.
FileHelper.SaveFile("absolute_file_path", bytes);
By default, if the file exists, the FileHelper creates a new file with a unique name and returns that name.
string existingFilePath = "D:\\readme.txt";
string newFilePath = FileHelper.SaveFile(existingFilePath, bytes); // Returns "D:\\readme_1.txt".
All parameters:
Param name
Param type
Description
path
string
The absolute file path to save to.
bytes
byte[]
The bytes to save to the file.
createDirIfNotExists
bool
The flag indicates to create destination directory if not exists. Default value is true.
useSequentialFileNameIfExists
bool
The flag indicates that target file name should be changed by adding sequential postfix if file with specfied name already exists. Default value is false.

SaveFileAsync()

Asynchronously saves a byte array to a file by an absolute path.
await FileHelper.SaveFileAsync("absolute_file_path", bytes);
By default, if the file exists, the FileHelper creates a new file with a unique name and returns that name.
string existingFilePath = "D:\\readme.txt";
string newFilePath = await FileHelper.SaveFileAsync(existingFilePath, bytes); // Returns "D:\\readme_1.txt".
All parameters:
Param name
Param type
Description
path
string
The absolute file path to save to.
bytes
byte[]
The bytes to save to the file.
createDirIfNotExists
bool
The flag indicates to create destination directory if not exists. Default value is true.
useSequentialFileNameIfExists
bool
The flag indicates that target file name should be changed by adding sequential postfix if file with specfied name already exists. Default value is false.
cancellationToken
CancellationToken
The token to monitor for cancellation requests. Default value is None.

ReadFile()

Synchronously reads a file from an absolute path to a byte array.
byte[] bytes = FileHelper.ReadFile(filePath);
All parameters:
Param name
Param type
Description
path
string
The absolute file path to read to.
throwIfNotExists
bool
The flag indicates to throw exception if file not exists. Default value is true.
You can also synchronously reads a file from a stream to a byte array.
byte[] bytes = FileHelper.ReadFile(stream);
All parameters:
Param name
Param type
Description
stream
Stream
The Stream (MemoryStream, FileStream, etc.).
initialLength
long
Length of returning byte array. Default value is 0.

ReadFileAsync()

Asynchronously reads a file from an absolute path to a byte array.
byte[] bytes = await FileHelper.ReadFileAsync(filePath);
All parameters:
Param name
Param type
Description
path
string
The absolute file path to read to.
throwIfNotExists
bool
The flag indicates to throw exception if file not exists. Default value is true.
cancellationToken
CancellationToken
The token to monitor for cancellation requests. Default value is None.
You can also asynchronously reads a file from a stream to a byte array.
byte[] bytes = await FileHelper.ReadFileAsync(stream);
All parameters:
Param name
Param type
Description
stream
Stream
The Stream (MemoryStream, FileStream, etc.).
initialLength
long
Length of returning byte array. Default value is 0.
cancellationToken
CancellationToken
The token to monitor for cancellation requests. Default value is None.

DeleteFile()

Deletes a file if it exists.
FileHelper.DeleteFile(filePath);
All parameters:
Param name
Param type
Description
path
string
The absolute file path to delete to.

GetFilePathWithSequentialFileName()

Returns an absolute path with variable destination file name with sequential postfix e.g. ("file_1.txt", "file_2.txt").
string existingFilePath = "D:\\readme.txt";
string newFilePath = FileHelper.GetFilePathWithSequentialFileName(existingFilePath); // Returns "D:\\readme_1.txt".
All parameters:
Param name
Param type
Description
path
string
The absolute file path.