FileInfo Class

Provides properties and instance methods for the creation, copying, deletion, moving, and opening of files, and aids in the creation of FileStream objects. This class cannot be inherited.

Inheritance Hierarchy

SystemObject
  SystemMarshalByRefObject
    Alphaleonis.Win32.FilesystemFileSystemInfo
      Alphaleonis.Win32.FilesystemFileInfo

Namespace: Alphaleonis.Win32.Filesystem
Assembly: AlphaFS (in AlphaFS.dll) Version: 2.2

Syntax

C++

Copy

[SerializableAttribute]
public sealed class FileInfo : FileSystemInfo

<SerializableAttribute>
Public NotInheritable Class FileInfo
	Inherits FileSystemInfo

[SerializableAttribute]
public ref class FileInfo sealed : public FileSystemInfo

[<SealedAttribute>]
[<SerializableAttribute>]
type FileInfo =  
    class
        inherit FileSystemInfo
    end

The FileInfo type exposes the following members.

Constructors

	Name	Description
	FileInfo(String)	Initializes a new instance of the FileInfo class, which acts as a wrapper for a file path.
	FileInfo(String, PathFormat)	[AlphaFS] Initializes a new instance of the FileInfo class, which acts as a wrapper for a file path.
	FileInfo(KernelTransaction, String)	[AlphaFS] Initializes a new instance of the FileInfo class, which acts as a wrapper for a file path.
	FileInfo(KernelTransaction, String, PathFormat)	[AlphaFS] Initializes a new instance of the FileInfo class, which acts as a wrapper for a file path.

Top

Properties

	Name	Description
	Attributes	Gets or sets the attributes for the current file or directory. (Inherited from FileSystemInfo.)
	CreationTime	Gets or sets the creation time of the current file or directory. (Inherited from FileSystemInfo.)
	CreationTimeUtc	Gets or sets the creation time, in coordinated universal time (UTC), of the current file or directory. (Inherited from FileSystemInfo.)
	Directory	Gets an instance of the parent directory.
	DirectoryName	Gets a string representing the directory's full path.
	DisplayPath	Returns the path as a string. (Inherited from FileSystemInfo.)
	EntryInfo	[AlphaFS] Gets the instance of the FileSystemEntryInfo class. (Inherited from FileSystemInfo.)
	Exists	Gets a value indicating whether the file exists. (Overrides FileSystemInfoExists.)
	Extension	Gets the string representing the extension part of the file. (Inherited from FileSystemInfo.)
	FullName	Gets the full path of the directory or file. (Inherited from FileSystemInfo.)
	IsDirectory	[AlphaFS] The initial "IsDirectory" indicator that was passed to the constructor. (Inherited from FileSystemInfo.)
	IsReadOnly	Gets or sets a value that determines if the current file is read only.
	LastAccessTime	Gets or sets the time the current file or directory was last accessed. (Inherited from FileSystemInfo.)
	LastAccessTimeUtc	Gets or sets the time, in coordinated universal time (UTC), that the current file or directory was last accessed. (Inherited from FileSystemInfo.)
	LastWriteTime	Gets or sets the time when the current file or directory was last written to. (Inherited from FileSystemInfo.)
	LastWriteTimeUtc	Gets or sets the time, in coordinated universal time (UTC), when the current file or directory was last written to. (Inherited from FileSystemInfo.)
	Length	Gets the size, in bytes, of the current file.
	LongFullName	The full path of the file system object in Unicode (LongPath) format. (Inherited from FileSystemInfo.)
	Name	Gets the name of the file. (Overrides FileSystemInfoName.)
	Transaction	[AlphaFS] Represents the KernelTransaction that was passed to the constructor. (Inherited from FileSystemInfo.)

Top

Methods

	Name	Description
	AppendText	Creates a StreamWriter that appends text to the file represented by this instance of the FileInfo.
	AppendText(Encoding)	Creates a StreamWriter that appends text to the file represented by this instance of the FileInfo.
	Compress	[AlphaFS] Compresses a file using NTFS compression.
	CopyTo(String)	Copies an existing file to a new file, disallowing the overwriting of an existing file. Return Value Type: A new FileInfo instance with a fully qualified path. Remarks Use this method to prevent overwriting of an existing file by default. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, PathFormat)	[AlphaFS] Copies an existing file to a new file, disallowing the overwriting of an existing file. Remarks Use this method to prevent overwriting of an existing file by default. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, Boolean)	Copies an existing file to a new file, allowing the overwriting of an existing file. Remarks Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, PathFormat)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, Boolean)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, Boolean, PathFormat)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file. Remarks Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, CopyMoveProgressRoutine, Object)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. and the possibility of notifying the application of its progress through a callback function. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, Boolean, PathFormat)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, CopyMoveProgressRoutine, Object, PathFormat)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, Boolean, CopyMoveProgressRoutine, Object)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. and the possibility of notifying the application of its progress through a callback function. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	CopyTo(String, CopyOptions, Boolean, CopyMoveProgressRoutine, Object, PathFormat)	[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file, CopyOptions can be specified. and the possibility of notifying the application of its progress through a callback function. Remarks Option NoBuffering is recommended for very large file transfers. Use this method to allow or prevent overwriting of an existing file. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	Create	Creates a file.
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	CreateText	Creates a instance that writes a new text file.
	Decompress	[AlphaFS] Decompresses an NTFS compressed file.
	Decrypt	Decrypts a file that was encrypted by the current account using the Encrypt method.
	Delete	Permanently deletes a file. (Overrides FileSystemInfoDelete.)
	Delete(Boolean)	[AlphaFS] Permanently deletes a file.
	Encrypt	Encrypts a file so that only the account used to encrypt the file can decrypt it.
	EnumerateAlternateDataStreams	[AlphaFS] Returns an enumerable collection of AlternateDataStreamInfo instances for the file.
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from FileSystemInfo.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetAccessControl	Gets a FileSecurity object that encapsulates the access control list (ACL) entries for the file described by the current FileInfo object.
	GetAccessControl(AccessControlSections)	Gets a FileSecurity object that encapsulates the specified type of access control list (ACL) entries for the file described by the current FileInfo object.
	GetFileId	[AlphaFS] Gets the unique identifier for the file. The identifier is composed of a 64-bit volume serial number and 128-bit file system entry identifier.
	GetHash	[AlphaFS] Calculates the hash/checksum.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from FileSystemInfo.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	IsLocked	[AlphaFS] Compresses a file using NTFS compression.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	MoveTo(String)	Moves a specified file to a new location, providing the option to specify a new file name. Remarks Use this method to prevent overwriting of an existing file by default. This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	MoveTo(String, MoveOptions)	[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name, MoveOptions can be specified. Return Value Type: Returns a new FileInfo instance with a fully qualified path when successfully moved, Remarks Use this method to allow or prevent overwriting of an existing file. This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	MoveTo(String, PathFormat)	[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name. Return Value Type: Returns a new FileInfo instance with a fully qualified path when successfully moved, Remarks Use this method to prevent overwriting of an existing file by default. This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	MoveTo(String, MoveOptions, PathFormat)	[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name, MoveOptions can be specified. Return Value Type: Returns a new FileInfo instance with a fully qualified path when successfully moved, Remarks Use this method to allow or prevent overwriting of an existing file. This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	MoveTo(String, MoveOptions, CopyMoveProgressRoutine, Object)	[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name, MoveOptions can be specified, and the possibility of notifying the application of its progress through a callback function. Remarks Use this method to allow or prevent overwriting of an existing file. This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	MoveTo(String, MoveOptions, CopyMoveProgressRoutine, Object, PathFormat)	[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name, MoveOptions can be specified. Remarks Use this method to allow or prevent overwriting of an existing file. This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt. Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method. If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.
	Open(FileMode)	Opens a file in the specified mode.
	Open(FileMode, FileAccess)	Opens a file in the specified mode with read, write, or read/write access.
	Open(FileMode, FileSystemRights)	[AlphaFS] Opens a file in the specified mode with read, write, or read/write access.
	Open(FileMode, FileAccess, FileShare)	Opens a file in the specified mode with read, write, or read/write access and the specified sharing option.
	Open(FileMode, FileSystemRights, FileShare)	[AlphaFS] Opens a file in the specified mode with read, write, or read/write access and the specified sharing option.
	OpenRead	Creates a read-only FileStream.
	OpenText	Creates a StreamReader with NativeMethods.DefaultFileEncoding encoding that reads from an existing text file.
	OpenText(Encoding)	[AlphaFS] Creates a StreamReader with Encoding that reads from an existing text file.
	OpenWrite	Creates a write-only FileStream.
	Refresh	Refreshes the state of the object. (Inherited from FileSystemInfo.)
	RefreshEntryInfo	Refreshes the state of the FileSystemEntryInfo EntryInfo instance.
	Replace(String, String)	Replaces the contents of a specified file with the file described by the current FileInfo object, deleting the original file, and creating a backup of the replaced file.
	Replace(String, String, PathFormat)	[AlphaFS] Replaces the contents of a specified file with the file described by the current FileInfo object, deleting the original file, and creating a backup of the replaced file. Also specifies whether to ignore merge errors.
	Replace(String, String, Boolean)	Replaces the contents of a specified file with the file described by the current FileInfo object, deleting the original file, and creating a backup of the replaced file. Also specifies whether to ignore merge errors.
	Replace(String, String, Boolean, PathFormat)	[AlphaFS] Replaces the contents of a specified file with the file described by the current FileInfo object, deleting the original file, and creating a backup of the replaced file. Also specifies whether to ignore merge errors.
	SetAccessControl(FileSecurity)	Applies access control list (ACL) entries described by a FileSecurity object to the file described by the current FileInfo object.
	SetAccessControl(FileSecurity, AccessControlSections)	Applies access control list (ACL) entries described by a FileSecurity object to the file described by the current FileInfo object.
	ToString	Returns the path as a string. (Overrides FileSystemInfoToString.)

Top

Fields

	Name	Description
	FullPath	Represents the fully qualified path of the file or directory. (Inherited from FileSystemInfo.)
	OriginalPath	The path originally specified by the user, whether relative or absolute. (Inherited from FileSystemInfo.)

Top

Reference

Alphaleonis.Win32.Filesystem Namespace

FileInfo Class

Return Value

Return Value

Return Value

Return Value

Reference