DirectoryInfo.CreateSubdirectory Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Cria um subdiretório ou subdiretórios no caminho especificado. O caminho especificado pode ser relativo a esta instância da classe DirectoryInfo.

Sobrecargas

CreateSubdirectory(String)

Cria um subdiretório ou subdiretórios no caminho especificado. O caminho especificado pode ser relativo a esta instância da classe DirectoryInfo.

CreateSubdirectory(String)

Origem:

DirectoryInfo.cs

Cria um subdiretório ou subdiretórios no caminho especificado. O caminho especificado pode ser relativo a esta instância da 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

Parâmetros

path

String

O caminho especificado. Não pode ser um nome UNC ou volume de disco diferente.

Retornos

DirectoryInfo

O último diretório especificado em path.

Exceções

ArgumentException

path não especifica um caminho de arquivo válido ou contém caracteres DirectoryInfo inválidos.

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido, por exemplo, ele está em uma unidade não mapeada.

IOException

Não é possível criar o subdiretório.

- ou -

Um arquivo já tem o nome especificado por path.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

SecurityException

O chamador não tem a permissão de acesso de código para criar o diretório.

- ou -

O chamador não tem permissão de acesso de código para ler o diretório descrito pelo objeto DirectoryInfo retornado. Isso pode ocorrer quando o parâmetro path descreve um diretório existente.

NotSupportedException

path contém um caractere de dois-pontos (:) que não faz parte de um rótulo da unidade (“C:\”).

Exemplos

O exemplo a seguir demonstra a criação de um subdiretório. Neste exemplo, os diretórios criados são removidos depois de criados. Portanto, para testar este exemplo, comente as linhas de exclusão no código.

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

Comentários

Todos e todos os diretórios especificados em path são criados, a menos que alguma parte do path seja inválida. O path parâmetro especifica um caminho de diretório, não um caminho de arquivo. Se o subdiretório já existir, esse método não fará nada.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo