/// <summary>
/// Deletes the specified file.
/// </summary>
/// <param name="path">
/// A <see cref="String"/> containing the path of the file to delete.
/// </param>
/// <exception cref="ArgumentNullException">
/// <paramref name="path"/> is <see langword="null"/>.
/// </exception>
/// <exception cref="ArgumentException">
/// <paramref name="path"/> is an empty string (""), contains only white
/// space, or contains one or more invalid characters as defined in
/// <see cref="Path.GetInvalidPathChars()"/>.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> contains one or more components that exceed
/// the drive-defined maximum length. For example, on Windows-based
/// platforms, components must not exceed 255 characters.
/// </exception>
/// <exception cref="PathTooLongException">
/// <paramref name="path"/> exceeds the system-defined maximum length.
/// For example, on Windows-based platforms, paths must not exceed
/// 32,000 characters.
/// </exception>
/// <exception cref="FileNotFoundException">
/// <paramref name="path"/> could not be found.
/// </exception>
/// <exception cref="DirectoryNotFoundException">
/// One or more directories in <paramref name="path"/> could not be found.
/// </exception>
/// <exception cref="UnauthorizedAccessException">
/// The caller does not have the required access permissions.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> refers to a file that is read-only.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> is a directory.
/// </exception>
/// <exception cref="IOException">
/// <paramref name="path"/> refers to a file that is in use.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> specifies a device that is not ready.
/// </exception>
public static void Delete(string path)
{
if (Common.IsRunningOnMono() && Common.IsPlatformUnix())
{
SysFile.Delete(path);
return;
}
string normalizedPath = Path.NormalizeLongPath(path);
if (!NativeMethods.DeleteFile(normalizedPath))
{
throw Common.GetExceptionFromLastWin32Error();
}
}
/// <summary>
/// Deletes the specified file.
/// </summary>
/// <param name="path">
/// A <see cref="String"/> containing the path of the file to delete.
/// </param>
/// <exception cref="ArgumentNullException">
/// <paramref name="path"/> is <see langword="null"/>.
/// </exception>
/// <exception cref="ArgumentException">
/// <paramref name="path"/> is an empty string (""), contains only white
/// space, or contains one or more invalid characters as defined in
/// <see cref="Path.GetInvalidPathChars()"/>.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> contains one or more components that exceed
/// the drive-defined maximum length. For example, on Windows-based
/// platforms, components must not exceed 255 characters.
/// </exception>
/// <exception cref="PathTooLongException">
/// <paramref name="path"/> exceeds the system-defined maximum length.
/// For example, on Windows-based platforms, paths must not exceed
/// 32,000 characters.
/// </exception>
/// <exception cref="FileNotFoundException">
/// <paramref name="path"/> could not be found.
/// </exception>
/// <exception cref="DirectoryNotFoundException">
/// One or more directories in <paramref name="path"/> could not be found.
/// </exception>
/// <exception cref="UnauthorizedAccessException">
/// The caller does not have the required access permissions.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> refers to a file that is read-only.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> is a directory.
/// </exception>
/// <exception cref="IOException">
/// <paramref name="path"/> refers to a file that is in use.
/// <para>
/// -or-
/// </para>
/// <paramref name="path"/> specifies a device that is not ready.
/// </exception>
public static void Delete(string path)
{
const int fileNotFoundWindowsErrorCode = 2;
if (Common.IsRunningOnMono() && Common.IsPlatformUnix())
{
SysFile.Delete(path);
return;
}
string normalizedPath = Path.NormalizeLongPath(path);
if (NativeMethods.DeleteFile(normalizedPath))
{
return;
}
if (fileNotFoundWindowsErrorCode == Marshal.GetLastWin32Error())
{
return;
}
throw Common.GetExceptionFromLastWin32Error();
}
