Online Help

QuickIO.NET online help is available on http://QuickIO.NET/help

Basics

All method signatures are based on the existing .NET Framework namespace System.IO
For this reason modern patterns and C# development policies cannot be applied perfectly.

 

Path Types

QuickIO.NET distinguishes and recognizes four types of paths.

  • UNC Share Path
      • Starts with \\?\UNC\
  • UNC Local Path
      • Starts with \\?\
  • Regular Share Path
      • Starts with \\
  • Regular Local Path
      • No prefix such as C:\

The reason for this is that long path names (up to 32767 characters) are supported only in UNC format by the Win32 API .
All internal calls to the Win32 API are done in the UNC format. Default message output (like in exceptions) are in the regular format.

The QuickIOFileInfo and QuickIODirectoryInfo types provide a property PathInfo of the QuickIOPathInfo which contains both path types. Or you can use the properties FullName and FullNameUnc directly.

 

Internal Path Handling


Any internal function of QuickIO.NET is using an instance of QuickIOPathInfo, which represents the path to a file or a folder.
However all methods accept the path as a string and convert it internally.
For example:

// Method receives path and overloads QuickIOPathInfo
public static void Create( string path, bool recursive = false )
{   
Create( new QuickIOPathInfo( path ), recursive ); } // Receive QuickIOPathInfo public static void Create( QuickIOPathInfo pathInfo, bool recursive = false ) {   
InternalQuickIO.CreateDirectory( pathInfo, recursive ); }

The most important class: QuickIOPathInfo

As already mentioned, the class QuickIOPathInfo provides the output of the path in regular and UNC format.
The QuickIOPathInfo knows whether the path represents a file or a folder. For this purpose the SystemEntryType property is provided. PathLocation property specifies whether it is a local path or a path to a network share.

Read the full documentation: QuickIOPathInfo Online Help

QuickIOPathInfo throws an PathNotFoundException if the specified path does not exist! You have to use the static create methods to create new files or folders!

 

Examples

Please check http://quickIO.net/Examples

 

Last edited Apr 6, 2014 at 9:43 PM by BenjaminAbt, version 4