DirectoryInfo.CreateSubdirectory Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Crea una o più sottodirectory nel percorso specificato. Il percorso specificato può essere relativo a questa istanza della classe DirectoryInfo.

Overload

CreateSubdirectory(String)

Crea una o più sottodirectory nel percorso specificato. Il percorso specificato può essere relativo a questa istanza della classe DirectoryInfo.

CreateSubdirectory(String)

Origine:

DirectoryInfo.cs

Crea una o più sottodirectory nel percorso specificato. Il percorso specificato può essere relativo a questa istanza della classe 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

Parametri

path

String

Percorso specificato. Non può essere un volume del disco o un nome UNC (Universal Naming Convention) diverso.

Restituisce

DirectoryInfo

Ultima directory specificata in path.

Eccezioni

ArgumentException

path non specifica un percorso file valido o contiene caratteri DirectoryInfo non validi.

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

IOException

Non è possibile creare la sottodirectory.

-oppure-

Un file ha già il nome specificato da path.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non è autorizzato ad accedere al codice per creare la directory.

-oppure-

Il chiamante non ha l'autorizzazione di accesso al codice per leggere la directory descritta dall'oggetto DirectoryInfo restituito. Questo problema può verificarsi quando il parametro path descrive una directory esistente.

NotSupportedException

path contiene un carattere due punti (:) che non fa parte di un'etichetta di unità ("C:\").

Esempio

Nell'esempio seguente viene illustrata la creazione di una sottodirectory. In questo esempio le directory create vengono rimosse una volta create. Pertanto, per testare questo esempio, commentare le righe di eliminazione nel codice.

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

Commenti

Tutte le directory specificate in path vengono create, a meno che non sia valida una parte di path . Il path parametro specifica un percorso della directory, non un percorso di file. Se la sottodirectory esiste già, questo metodo non fa nulla.

Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

• File e Stream I/O
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file