AlphaFS 2.2 Documentation
API Reference
Alphaleonis.Win32.Filesystem
AlreadyExistsException Class
AlternateDataStreamInfo Structure
BackupFileStream Class
BackupStreamInfo Class
ByHandleFileInfo Class
CopyMoveProgressCallbackReason Enumeration
CopyMoveProgressResult Enumeration
CopyMoveProgressRoutine Delegate
CopyMoveResult Class
CopyOptions Enumeration
Device Class
DeviceGuid Enumeration
DeviceInfo Class
DeviceNotReadyException Class
Directory Class
DirectoryEnumerationFilters Class
DirectoryEnumerationOptions Enumeration
DirectoryInfo Class
DirectoryNotEmptyException Class
DirectoryReadOnlyException Class
DiskSpaceInfo Class
DosDeviceAttributes Enumeration
DriveInfo Class
ErrorHandler Delegate
ExtendedFileAttributes Enumeration
File Class
FileEncryptionStatus Enumeration
FileIdBothDirectoryInfo Class
FileIdInfo Structure
FileInfo Class
FileReadOnlyException Class
FileSystemEntryInfo Class
FileSystemInfo Class
FinalPathFormats Enumeration
GetFullPathOptions Enumeration
InvalidTransactionException Class
KernelTransaction Class
LinkTargetInfo Class
MoveOptions Enumeration
NotAReparsePointException Class
NotSameDeviceException Class
Path Class
PathFormat Enumeration
ReparsePointTag Enumeration
SafeFindFileHandle Class
SafeFindVolumeHandle Class
Shell32 Class
Shell32.AssociationAttributes Enumeration
Shell32.AssociationString Enumeration
Shell32.FileAttributes Enumeration
Shell32.FileInfo Structure
Shell32.GetAttributesOf Enumeration
Shell32.UrlType Enumeration
Shell32Info Class
STREAM_ATTRIBUTES Enumeration
STREAM_ID Enumeration
SymbolicLinkTarget Enumeration
SymbolicLinkTargetInfo Class
SymbolicLinkType Enumeration
TransactionalConflictException Class
TransactionAlreadyAbortedException Class
TransactionAlreadyCommittedException Class
TransactionException Class
UnrecognizedReparsePointException Class
UnsupportedRemoteTransactionException Class
Volume Class
VolumeInfo Class
Click or drag to resize

PathFormat Enumeration

Indicates the format of a path passed to a method.

Namespace:  Alphaleonis.Win32.Filesystem
Assembly:  AlphaFS (in AlphaFS.dll) Version: 2.2
Syntax
Copy
public enum PathFormat
Members
  Member nameValueDescription
RelativePath0The format of the path is automatically detected by the method and internally converted to an extended length path. It can be either a standard (short) full path, an extended length (unicode) full path or a relative path.

Example relative path: "Windows".

FullPath1The path is a full path in either normal or extended length (UNICODE) format. Internally it will be converted to an extended length (UNICODE) path. Using this option has a very slight performance advantage compared to using RelativePath.

Example full path: "C:\Windows" or "\\server\share".

LongFullPath2The path is an extended length path. No additional processing will be done on the path, and it will be used as-is. Using this option has a slight performance advantage compared to using RelativePath.

Example long full path: "\\?\C:\Windows" or "\\?\UNC\server\share".

Remarks
At some point in code you know the full path of file system objects, e.g.: "C:\Windows". For example, Directory.EnumerateFileSystemEntries() will return all files and directories from a given path. Most likely, some processing will happen on the results of the enum. The file or directory may be passed on to another function. Whenever a file path is required, some performance can be gained.

 

A path like: "C:\Windows" or "\\server\share" is considered a full path for a directory because it is rooted and has a drive/unc path. If the method supports it, FullPath and LongFullPath will skip GetFullPath() calls for path resolving of the object, while also avoiding path validation and checks. Using RelativePath (default) will always call GetFullPath() and perform path validation and checks.

 

When working in a loop with thousands of files, LongFullPath will give the best performance.
See Also