DirectoryInfo.CreateSubdirectory Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Tworzy podkatalog lub podkatalog na określonej ścieżce. Określona ścieżka może być względna względem tego wystąpienia DirectoryInfo klasy.

Przeciążenia

CreateSubdirectory(String)

Tworzy podkatalog lub podkatalog na określonej ścieżce. Określona ścieżka może być względna względem tego wystąpienia DirectoryInfo klasy.

CreateSubdirectory(String)

Źródło:

DirectoryInfo.cs

Tworzy podkatalog lub podkatalog na określonej ścieżce. Określona ścieżka może być względna względem tego wystąpienia DirectoryInfo klasy.

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

Parametry

path

String

Określona ścieżka. Nie może to być inny wolumin dysku ani nazwa UNC (Universal Naming Convention).

Zwraca

DirectoryInfo

Ostatni katalog określony w pliku path.

Wyjątki

ArgumentException

path nie określa prawidłowej ścieżki pliku lub zawiera nieprawidłowe DirectoryInfo znaki.

ArgumentNullException

path to null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa, na przykład na dysku niezamapowanym.

IOException

Nie można utworzyć podkatalogu.

-lub-

Plik ma już nazwę określoną przez path.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

SecurityException

Obiekt wywołujący nie ma uprawnień dostępu do kodu w celu utworzenia katalogu.

-lub-

Obiekt wywołujący nie ma uprawnień dostępu kodu do odczytu katalogu opisanego przez zwrócony DirectoryInfo obiekt. Taka sytuacja może wystąpić, gdy path parametr opisuje istniejący katalog.

NotSupportedException

path zawiera znak dwukropka (:), który nie jest częścią etykiety dysku ("C:\").

Przykłady

W poniższym przykładzie pokazano tworzenie podkatalogu. W tym przykładzie utworzone katalogi są usuwane po utworzeniu. W związku z tym, aby przetestować ten przykład, oznacz jako komentarz wiersze usuwania w kodzie.

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

Uwagi

Wszystkie katalogi określone w pliku path i są tworzone, chyba że część elementu jest nieprawidłowa path . Parametr path określa ścieżkę katalogu, a nie ścieżkę pliku. Jeśli podkatalog już istnieje, ta metoda nic nie robi.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• We/wy plików i Stream
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku