Directory.Delete 方法

定义

命名空间:: System.IO

程序集:: mscorlib.dll, System.IO.FileSystem.dll

程序集:: mscorlib.dll

程序集:: System.IO.FileSystem.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

删除指定的目录，并选择性地删除任何子目录。

重载

名称	说明
Delete(String)	从指定路径中删除空目录。
Delete(String, Boolean)	删除指定的目录，如果指示，则删除目录中的任何子目录和文件。

Delete(String)

从指定路径中删除空目录。

public:
 static void Delete(System::String ^ path);

public static void Delete(string path);

static member Delete : string -> unit

Public Shared Sub Delete (path As String)

参数

path: String

要删除的空目录的名称。此目录必须可写且为空。

例外

IOException

存在同名和位置 path 的文件。

-或-

指定的 path 目录不为空。

-或-

目录正由另一个进程使用。

UnauthorizedAccessException

调用方没有所需的权限。

ArgumentException

低于 2.1 的 .NET Framework 和 .NET Core 版本： path 是长度为零的字符串，仅包含空格，或包含一个或多个无效字符。可以使用该方法 GetInvalidPathChars() 查询无效字符。

ArgumentNullException

path 是 null。

PathTooLongException

指定的路径、文件名或两者都超过了系统定义的最大长度。

DirectoryNotFoundException

path 不存在或找不到。

-或-

指定的路径无效（例如，它位于未映射的驱动器上）。

示例

以下示例演示如何创建新的目录和子目录，然后仅删除子目录。

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string subPath = @"C:\NewDirectory\NewSubDirectory";

            try
            {
                Directory.CreateDirectory(subPath);
                Directory.Delete(subPath);

                bool directoryExists = Directory.Exists(@"C:\NewDirectory");
                bool subDirectoryExists = Directory.Exists(subPath);

                Console.WriteLine("top-level directory exists: " + directoryExists);
                Console.WriteLine("sub-directory exists: " + subDirectoryExists);
            }
            catch (Exception e)
            {
                Console.WriteLine("The process failed: {0}", e.Message);
            }
        }
    }
}

open System.IO

let subPath = @"C:\NewDirectory\NewSubDirectory"

try
    Directory.CreateDirectory subPath |> ignore
    Directory.Delete subPath

    let directoryExists = Directory.Exists @"C:\NewDirectory"
    let subDirectoryExists = Directory.Exists subPath

    printfn $"top-level directory exists: {directoryExists}"
    printfn $"sub-directory exists: {subDirectoryExists}"
with e ->
    printfn $"The process failed: {e.Message}"

Imports System.IO

Module Module1

    Sub Main()
        Dim subPath = "C:\NewDirectory\NewSubDirectory"

        Try
            Directory.CreateDirectory(subPath)
            Directory.Delete(subPath)

            Dim directoryExists = Directory.Exists("C:\NewDirectory")
            Dim subDirectoryExists = Directory.Exists(subPath)

            Console.WriteLine("top-level directory exists: " & directoryExists)
            Console.WriteLine("sub-directory exists: " & subDirectoryExists)

        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.Message)
        End Try
    End Sub

End Module

注解

此方法的行为与Delete(String, Boolean)false为第二个参数指定的相同。

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

删除目录之前， path 将从参数末尾删除尾随空格。

此方法引发 IOException 参数中指定的 path 目录是否包含文件或子目录。

参数的 path 区分大小写对应于运行代码的文件系统。例如，它在 NTFS（默认 Windows 文件系统）上不区分大小写，在 Linux 文件系统上区分大小写。

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

另请参阅

适用于

Delete(String, Boolean)

删除指定的目录，如果指示，则删除目录中的任何子目录和文件。

public:
 static void Delete(System::String ^ path, bool recursive);

public static void Delete(string path, bool recursive);

static member Delete : string * bool -> unit

Public Shared Sub Delete (path As String, recursive As Boolean)

参数

path: String

要删除的目录的名称。

recursive: Boolean

true 如果删除目录、子目录和文件，则 path为 ;否则为 false。

例外