DirectoryInfo.CreateSubdirectory 方法

定義

命名空間:: 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 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在指定路徑上建立子目錄或子目錄。指定的路徑可以相對於該類別的 DirectoryInfo 實例。

多載

名稱	Description
CreateSubdirectory(String)	在指定路徑上建立子目錄或子目錄。指定的路徑可以相對於該類別的 DirectoryInfo 實例。
CreateSubdirectory(String, DirectorySecurity)	在指定路徑上建立一個或多個子目錄，並具備指定的安全性。指定的路徑可以相對於該類別的 DirectoryInfo 實例。

CreateSubdirectory(String)

來源:: DirectoryInfo.cs

來源:: DirectoryInfo.cs

來源:: DirectoryInfo.cs

來源:: DirectoryInfo.cs

來源:: DirectoryInfo.cs

在指定路徑上建立子目錄或子目錄。指定的路徑可以相對於該類別的 DirectoryInfo 實例。

public:
 System::IO::DirectoryInfo ^ CreateSubdirectory(System::String ^ path);

public System.IO.DirectoryInfo CreateSubdirectory(string path);

member this.CreateSubdirectory : string -> System.IO.DirectoryInfo

Public Function CreateSubdirectory (path As String) As DirectoryInfo

參數

path: String

指定的路徑。這不能是不同的磁碟磁碟區或通用命名規則（UNC）名稱。

傳回

DirectoryInfo

最後一個目錄在 path中指定。

例外狀況

ArgumentException

path 不指定有效的檔案路徑或包含無效 DirectoryInfo 字元。

ArgumentNullException

path 是 null。

DirectoryNotFoundException

指定的路徑無效，例如位於未對應的磁碟驅動器上。

IOException

子目錄無法被建立。

-或-

檔案名稱已 path由。

PathTooLongException

指定的路徑、檔名或兩者都超過系統定義的最大長度。

SecurityException

呼叫者沒有程式碼存取權限來建立該目錄。

-或-

呼叫者沒有程式碼存取權限來讀取回傳 DirectoryInfo 物件所描述的目錄。當參數 path 描述現有目錄時，這可能發生。

NotSupportedException

path 包含一個冒號字元（:)，且非磁碟機標籤的一部分（「C：\」）。

範例

以下範例示範如何建立子目錄。在此範例中，建立的目錄一旦建立就會被移除。因此，為了測試這個範例，請註解程式碼中的刪除行。

using System;
using System.IO;

public class CreateSubTest
{
    public static void Main()
    {
        // Create a reference to a directory.
        DirectoryInfo di = new DirectoryInfo("TempDir");

        // Create the directory only if it does not already exist.
        if (!di.Exists)
            di.Create();

        // Create a subdirectory in the directory just created.
        DirectoryInfo dis = di.CreateSubdirectory("SubDir");

        // Process that directory as required.
        // ...

        // Delete the subdirectory.
        dis.Delete(true);

        // Delete the directory.
        di.Delete(true);
    }
}

open System.IO

// Create a reference to a directory.
let di = DirectoryInfo "TempDir"

// Create the directory only if it does not already exist.
if not di.Exists then
    di.Create()

// Create a subdirectory in the directory just created.
let dis = di.CreateSubdirectory "SubDir"

// Process that directory as required.
// ...

// Delete the subdirectory.
dis.Delete true

// Delete the directory.
di.Delete true

Imports System.IO

Public Class CreateSubTest

    Public Shared Sub Main()
        ' Make a reference to a directory.
        Dim di As New DirectoryInfo("TempDir")

        ' Create the directory only if it does not already exist.
        If di.Exists = False Then
            di.Create()
        End If

        ' Create a subdirectory in the directory just created.
        Dim dis As DirectoryInfo = di.CreateSubdirectory("SubDir")

        ' Process that directory as required.
        ' ...

        ' Delete the subdirectory.
        dis.Delete(True)

        ' Delete the directory.
        di.Delete(True)
    End Sub
End Class

備註

所有指定的 path 目錄都會被建立，除非其中 path 某些部分無效。該 path 參數指定的是目錄路徑，而非檔案路徑。如果子目錄已經存在，這個方法就不會做任何事。

關於常見 I/O 任務的清單，請參見 Common I/O 任務。

另請參閱

適用於

CreateSubdirectory(String, DirectorySecurity)

在指定路徑上建立一個或多個子目錄，並具備指定的安全性。指定的路徑可以相對於該類別的 DirectoryInfo 實例。

public:
 System::IO::DirectoryInfo ^ CreateSubdirectory(System::String ^ path, System::Security::AccessControl::DirectorySecurity ^ directorySecurity);

public System.IO.DirectoryInfo CreateSubdirectory(string path, System.Security.AccessControl.DirectorySecurity directorySecurity);

member this.CreateSubdirectory : string * System.Security.AccessControl.DirectorySecurity -> System.IO.DirectoryInfo

Public Function CreateSubdirectory (path As String, directorySecurity As DirectorySecurity) As DirectoryInfo

參數

path: String