Directory.Delete 方法

定義

命名空間:: System.IO

組件:: mscorlib.dll, System.IO.FileSystem.dll

組件:: netstandard.dll, System.Runtime.dll

組件:: netstandard.dll, System.IO.FileSystem.dll

組件:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

組件:: System.IO.FileSystem.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
Delete(String)	刪除指定路徑上的空目錄。
Delete(String, Boolean)	刪除指定的目錄，若有指定，則刪除目錄中的任何子目錄和檔案。

Delete(String)

來源:: Directory.cs

來源:: Directory.cs

來源:: Directory.cs

來源:: Directory.cs

來源:: Directory.cs

刪除指定路徑上的空目錄。

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

.NET Framework 與 .NET Core 版本 2.1 以前： 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)

來源:: Directory.cs

來源:: Directory.cs

來源:: Directory.cs

來源:: Directory.cs

來源:: Directory.cs

刪除指定的目錄，若有指定，則刪除目錄中的任何子目錄和檔案。

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。