DirectoryInfo.CreateSubdirectory 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

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

多載

CreateSubdirectory(String)

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

CreateSubdirectory(String)

來源:

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 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 工作。

另請參閱

• 檔案和資料流程 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案