DirectoryInfo.CreateSubdirectory Método

  • Referência

Definição

Namespace:
System.IO
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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, DirectorySecurity)

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

CreateSubdirectory(String)

Origem:
DirectoryInfo.cs
Origem:
DirectoryInfo.cs
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

Aplica-se a

CreateSubdirectory(String, DirectorySecurity)

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

Parâmetros

path
String

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

directorySecurity
DirectorySecurity

A segurança a ser aplicada.

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 ou diretório 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:\”).

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.

Aplica-se a