System.IO.Directory.Delete 方法 (String, Boolean)

方法描述

删除指定的目录并(如果指示)删除该目录中的所有子目录和文件。

语法定义(C# System.IO.Directory.Delete 方法 (String, Boolean) 的用法)

public static void Delete(
	string path,
	bool recursive
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
path System-String 要移除的目录的名称。
recursive System-Boolean 若要移除 path 中的目录、子目录和文件,则为 true;否则为 false。
返回值 void

提示和注释

path 参数可以指定相对或绝对路径信息。 相对路径信息被解释为相对于当前工作目录。 若要获取当前工作目录,请参见 GetCurrentDirectory。

path 参数不区分大小写。

如果 recursive 参数为 true,则用户必须具有当前目录及其所有子目录的写权限。

当删除一个包含重分析点(例如符号链接或装入点)的目录时,此方法的行为稍有不同。 如果该重分析点为目录(例如装入点),则其将被卸载并且装入点将被删除。 该方法不通过该重分析点递归。 如果该重分析点为某个文件的符号链接,则该重分析点被删除并且不是此符号链接的目标。

在某些情况下,如果指定的目录在 Windows 资源管理器中打开,则 Delete 方法可能无法删除它。

System.IO.Directory.Delete 方法 (String, Boolean)例子

下面的代码示例创建并删除指定的目录和子目录。

using System;
using System.IO;

class Test 
{
	
    public static void Main() 
    {
        // Specify the directories you want to manipulate.
        string path = @"c:\MyDir";
        string subPath = @"c:\MyDir\temp";

        try 
        {
            // Determine whether the directory exists.
            if (!Directory.Exists(path)) 
            {
                // Create the directory.
                Directory.CreateDirectory(path);
            }


            if (!Directory.Exists(subPath)) 
            {
                // Create the directory.
                Directory.CreateDirectory(subPath);
            }

            // This will succeed because subdirectories are being deleted.
            Console.WriteLine("I am about to attempt to delete {0}", path);
            Directory.Delete(path, true);
            Console.WriteLine("The Delete operation was successful.");

        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        } 
        finally {}
    }
}

异常

异常 异常描述
IOException
  • 存在具有相同名称和 path 指定的位置的文件。
  • path 指定的目录是只读的,或者 recursive 是 false 并且 path 不是空目录。
  • 该目录为应用程序的当前工作目录。
  • 目录中包含一个只读文件。
  • 该目录正被另一个进程使用。 对于目录或其文件之一有打开句柄,并且操作系统是 Windows XP 或更早版本。 此打开句柄可能是由于枚举目录和文件导致的。 有关更多信息,请参见 如何:枚举目录和文件。
UnauthorizedAccessException 调用方没有所要求的权限。
ArgumentException path 是一个零长度字符串,仅包含空白或者包含一个或多个由 InvalidPathChars 定义的无效字符。
ArgumentNullException path 为 null。
PathTooLongException 指定的路径、文件名或者两者都超出了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。
DirectoryNotFoundException
  • path 不存在或未能找到。
  • path 指向文件而不是目录。
  • 指定的路径无效(例如,它位于未映射的驱动器上)。

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。