共用方式為


DirectoryInfo.CreateSubdirectory 方法

定義

在指定路徑上建立子目錄。 指定的路徑可以相對於 DirectoryInfo 類別的這個執行個體。

多載

CreateSubdirectory(String)

在指定路徑上建立子目錄。 指定的路徑可以相對於 DirectoryInfo 類別的這個執行個體。

CreateSubdirectory(String, DirectorySecurity)

使用指定的安全性在指定路徑上建立子目錄。 指定的路徑可以相對於 DirectoryInfo 類別的這個執行個體。

CreateSubdirectory(String)

來源:
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) 名稱。

傳回

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

例外狀況

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

pathnull

指定的路徑無效,例如位於未對應的磁碟機上。

無法建立子目錄。

-或-

檔案已經有 所 path指定的名稱。

指定的路徑、檔案名稱,或兩者都超出系統定義的長度上限。

呼叫端沒有程式碼存取權限,不能建立目錄。

-或-

呼叫端沒有程式碼存取權限,不能讀取傳回的 DirectoryInfo 物件所描述的目錄。 當 path 參數描述現有的目錄時就會發生這種情況。

path 包含不是磁碟機標籤 ("C:\") 一部分的冒號字元 (:)。

範例

下列範例示範如何建立子目錄。 在此範例中,建立的目錄會在建立之後移除。 因此,若要測試此範例,請將程式代碼中的刪除行批注化。

using namespace System;
using namespace System::IO;
int main()
{
   
   // Create a reference to a directory.
   DirectoryInfo^ di = gcnew DirectoryInfo( "TempDir" );
   
   // Create the directory only if it does not already exist.
   if ( di->Exists == false )
      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 );
}
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 == false)
            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 工作的清單,請參閱 一般 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

指定的路徑。 不能是不同的磁碟區或通用命名慣例 (UNC) 名稱。

directorySecurity
DirectorySecurity

要套用的安全性。

傳回

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

例外狀況

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

pathnull

指定的路徑無效,例如位於未對應的磁碟機上。

無法建立子目錄。

-或-

檔案或目錄已有 path 指定的名稱。

指定的路徑、檔案名稱,或兩者都超出系統定義的長度上限。

呼叫端沒有程式碼存取權限,不能建立目錄。

-或-

呼叫端沒有程式碼存取權限,不能讀取傳回的 DirectoryInfo 物件所描述的目錄。 當 path 參數描述現有的目錄時就會發生這種情況。

path 包含不是磁碟機標籤 ("C:\") 一部分的冒號字元 (:)。

備註

除非 的path某個部分無效,否則會建立 中path指定的任何和所有目錄。 參數 path 會指定目錄路徑,而不是檔案路徑。 如果子目錄已經存在,這個方法就不會執行任何動作。

如需一般 I/O 工作的清單,請參閱 一般 I/O 工作

適用於