An interface representing a file in the filesystem. More...

Public Member Functions
void	Create ()
	Creates the file without content. More...

void	Create (SystemIO.Stream contents)
	Creates the file with `content`. More...

SystemIO.Stream	CreateAndOpen ()
	Creates the file on the filesystem and opens it for writing. More...

SystemIO.Stream	Open (SystemIO.FileMode mode)
	Opens the file for reading or writing. More...

File	CopyTo (string dstPath, bool overwrite=false)
	Copies the file to a different path. More...

File	CopyTo (FilesystemPath dstPath, bool overwrite=false)
	Copies the file to a different path. More...

File	MoveTo (string dstPath)
	Moves the file to a different location. More...

File	MoveTo (FilesystemPath dstPath)
	Moves the file to a different location. More...

void	Delete ()
	Deletes the file on from the filesystem. More...

File	Replace (string dstPath, string backupPath)
	Replaces the file at `dstPath` with this file creating a backup in `backupPath`. More...

File	Replace (FilesystemPath dstPath, FilesystemPath backupPath)
	Replaces the file at `dstPath` with this file creating a backup in `backupPath`. More...

File	Replace (File dstFile, File backup)
	Replaces the file at `dstFile` with this file creating a backup in `backup`. More...

File	ReplaceWith (string srcPath, string backupPath)
	Replace this file's content with the content of the file at @psrcPath. More...

File	ReplaceWith (FilesystemPath srcPath, FilesystemPath backupPath)
	Replace this file's content with the content of the file at @psrcPath. More...

File	ReplaceWith (File srcFile, File backup)
	Replace this file's content with the content of `srcFile`. More...

Properties
String	Name `[get]`

String	Extension `[get]`
	The extension of the file. More...

FilesystemPath	Path `[get]`
	The path of the file. More...

Folder	Folder `[get]`
	The folder where the file is located. More...

DateTime	LastModificationTime `[get]`
	The time the file was last changed. More...

DateTime	CreationTime `[get]`
	The time the file was created. More...

bool	Exists `[get]`
	Checks if the file exists in the filesystem. More...

bool	IsWritable `[get]`
	Checks if the file is writable in the filesystem. More...

Detailed Description

An interface representing a file in the filesystem.

Member Function Documentation

◆ CopyTo() [1/2]

File Joutsen.IO.File.CopyTo	(	FilesystemPath	dstPath,
		bool	overwrite = `false`
	)

Copies the file to a different path.

Parameters

dstPath	the path to copy the file to
overwrite	determines if an existing file at `dstPath` should be overwritten

Returns: the file representing the copy

Exceptions

System.ArgumentNullException if dstPath is null

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ CopyTo() [2/2]

File Joutsen.IO.File.CopyTo	(	string	dstPath,
		bool	overwrite = `false`
	)

Copies the file to a different path.

Parameters

dstPath	the path to copy the file to
overwrite	determines if an existing file at `dstPath` should be overwritten

Returns: the file representing the copy

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Create() [1/2]

void Joutsen.IO.File.Create ( )

Creates the file without content.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Create() [2/2]

void Joutsen.IO.File.Create ( SystemIO.Stream contents )

Creates the file with content.

Parameters

content the content that should be written to the new file

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ CreateAndOpen()

SystemIO.Stream Joutsen.IO.File.CreateAndOpen ( )

Creates the file on the filesystem and opens it for writing.

Returns: the open stream which can be used to write to the file

Remarks: The caller has to take care of closing the stream.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Delete()

void Joutsen.IO.File.Delete ( )

Deletes the file on from the filesystem.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ MoveTo() [1/2]

File Joutsen.IO.File.MoveTo ( FilesystemPath dstPath )

Moves the file to a different location.

Parameters

dstPath the path to move the file to

Returns: the file representing the moved file

Exceptions

System.ArgumentNullException if dstPath is null

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ MoveTo() [2/2]

File Joutsen.IO.File.MoveTo ( string dstPath )

Moves the file to a different location.

Parameters

dstPath the path to move the file to

Returns: the file representing the moved file

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Open()

SystemIO.Stream Joutsen.IO.File.Open ( SystemIO.FileMode mode )

Opens the file for reading or writing.

Parameters

mode	determines if the file is opened for reading or writing

Returns: a stream representing the files content

Remarks: The stream is not closed automatically. The caller needs to take care of properly closing it.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Replace() [1/3]

File Joutsen.IO.File.Replace	(	File	dstFile,
		File	backup
	)

Replaces the file at dstFile with this file creating a backup in backup.

Parameters

dstFile	the file that should be replaced
backup	the file where the backup of `dstFile` should be stored

Returns: a file representing the backup of the replaced file or null if no backup is created

Exceptions

System.ArgumentNullException if dstFile is null

Remarks: If null is passed as backup, no backup is created.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Replace() [2/3]

File Joutsen.IO.File.Replace	(	FilesystemPath	dstPath,
		FilesystemPath	backupPath
	)

Replaces the file at dstPath with this file creating a backup in backupPath.

Parameters

dstpath	the path to the file that should be replaced
backupPath	the path to the location where the backup of `the` file at dstPath should be stored

Returns: a file representing the backup of the replaced file or null if no backup is created

Exceptions

System.ArgumentNullException if dstPath is null

Remarks: If null is passed as backupPath, no backup is created. The original file is deleted by this method.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Replace() [3/3]

File Joutsen.IO.File.Replace	(	string	dstPath,
		string	backupPath
	)

Replaces the file at dstPath with this file creating a backup in backupPath.

Parameters

dstpath	the path to the file that should be replaced
backupPath	the path to the location where the backup of `the` file at dstPath should be stored

Returns: a file representing the backup of the replaced file or null if no backup is created

Remarks: If null is passed as backupPath, no backup is created. The original file is deleted by this method.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ ReplaceWith() [1/3]

File Joutsen.IO.File.ReplaceWith	(	File	srcFile,
		File	backup
	)

Replace this file's content with the content of srcFile.

Parameters

srcFile	the file that contains the content which should replace this file
backup	the file where the backup of this file should be stored

Returns: a file representing the backup of this file or null if no backup is created

Exceptions

System.ArgumentNullException if srcFile is null

Remarks: If null is passed as backup, no backup is created.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ ReplaceWith() [2/3]

File Joutsen.IO.File.ReplaceWith	(	FilesystemPath	srcPath,
		FilesystemPath	backupPath
	)

Replace this file's content with the content of the file at @psrcPath.

Parameters

srcPath	the path to the file that contains the content which should replace this file
backup	the file where the backup of this file should be stored

Returns: a file representing the backup of this file or null if no backup is created

Exceptions

System.ArgumentNullException if srcFile is null

Remarks: If null is passed as backup, no backup is created.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ ReplaceWith() [3/3]

File Joutsen.IO.File.ReplaceWith	(	string	srcPath,
		string	backupPath
	)

Replace this file's content with the content of the file at @psrcPath.

Parameters

srcPath	the path to the file that contains the content which should replace this file
backup	the file where the backup of this file should be stored

Returns: a file representing the backup of this file or null if no backup is created

Exceptions

System.ArgumentNullException if srcFile is null

Remarks: If null is passed as backup, no backup is created.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

Property Documentation

◆ CreationTime

DateTime Joutsen.IO.File.CreationTime

get

The time the file was created.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Exists

bool Joutsen.IO.File.Exists

get

Checks if the file exists in the filesystem.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Extension

String Joutsen.IO.File.Extension

get

The extension of the file.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Folder

Folder Joutsen.IO.File.Folder

get

The folder where the file is located.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ IsWritable

bool Joutsen.IO.File.IsWritable

get

Checks if the file is writable in the filesystem.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ LastModificationTime

DateTime Joutsen.IO.File.LastModificationTime

get

The time the file was last changed.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Name

String Joutsen.IO.File.Name

get

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

◆ Path

FilesystemPath Joutsen.IO.File.Path

get

The path of the file.

Implemented in Joutsen.IO.LocalFile, and Joutsen.IO.TemporaryFile.

Public Member Functions

Properties

Detailed Description

Member Function Documentation

◆ CopyTo() [1/2]

◆ CopyTo() [2/2]

◆ Create() [1/2]

◆ Create() [2/2]

◆ CreateAndOpen()

◆ Delete()

◆ MoveTo() [1/2]

◆ MoveTo() [2/2]

◆ Open()

◆ Replace() [1/3]

◆ Replace() [2/3]

◆ Replace() [3/3]

◆ ReplaceWith() [1/3]

◆ ReplaceWith() [2/3]

◆ ReplaceWith() [3/3]

Property Documentation

◆ CreationTime

◆ Exists

◆ Extension

◆ Folder

◆ IsWritable

◆ LastModificationTime

◆ Name

◆ Path