/// <summary>
/// Creates a new directory. If <paramref name="recursive"/> is false, the parent directory must exist.
/// </summary>
/// <param name="path">The directory.</param>
/// <param name="recursive">If <paramref name="recursive"/> is false, the parent directory must exist.</param>
/// <remarks>http://msdn.microsoft.com/en-us/library/54a0at6s(v=vs.110).aspx</remarks>
/// <exception cref="PathAlreadyExistsException">The specified path already exists.</exception>
/// <exception cref="PathNotFoundException">One or more intermediate directories do not exist; this function will only create the final directory in the path.</exception>
/// <example>
/// Creates directory structure
/// <code>
/// public static void Create_With_PathInfo_Example( );
/// {
/// QuickIOPathInfo pathInfo = new QuickIOPathInfo( @"C:\temp\QuickIOTest\sub\folder\tree" );
///
/// // Creates directory C:\temp\QuickIOTest\sub\folder\tree and all not existing parent folders
/// QuickIODirectory.Create( pathInfo, recursive: true );
/// }
/// </code>
/// </example>
/// <example>
/// Shows how to handle sample exception if parent directory does not exist.
/// <code>
/// public static void Create_With_StringPath_Example()
/// {
/// QuickIOPathInfo pathInfo = new QuickIOPathInfo( @"C:\temp\QuickIOTest\sub\folder\tree" );
///
/// try
/// {
/// QuickIODirectory.Create( pathInfo, recursive: false );
/// }
/// catch ( PathNotFoundException pathNotFoundException )
/// {
/// // Parent directory does not exist.
/// }
/// }
/// </code>
/// </example>
public static void Create(QuickIOPathInfo path, bool recursive = false)
{
Contract.Requires(path != null);
InternalQuickIO.CreateDirectory(path.FullNameUnc, recursive);
}
