Directory.CreateDirectory Método

Definição

Cria todos os diretórios num caminho especificado.

Sobrecargas

Name Description
CreateDirectory(String)

Cria todos os diretórios e subdiretórios no caminho especificado, a menos que já existam.

CreateDirectory(String, UnixFileMode)

Cria todos os diretórios e subdiretórios no caminho especificado com as permissões especificadas, a menos que já existam.

CreateDirectory(String, DirectorySecurity)

Cria todos os diretórios no caminho especificado, a menos que já existam, aplicando a segurança do Windows especificada.

CreateDirectory(String)

Origem:
Directory.cs
Origem:
Directory.cs
Origem:
Directory.cs
Origem:
Directory.cs
Origem:
Directory.cs

Cria todos os diretórios e subdiretórios no caminho especificado, a menos que já existam.

public:
 static System::IO::DirectoryInfo ^ CreateDirectory(System::String ^ path);
public static System.IO.DirectoryInfo CreateDirectory(string path);
static member CreateDirectory : string -> System.IO.DirectoryInfo
Public Shared Function CreateDirectory (path As String) As DirectoryInfo

Parâmetros

path
String

O diretório a criar.

Devoluções

Um objeto que representa o diretório no caminho especificado. Este objeto é devolvido independentemente de já existir um diretório no caminho especificado.

Exceções

O diretório especificado por path é um ficheiro.

-ou-

O nome da rede é desconhecido.

O interlocutor não tem a permissão necessária.

.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars() método.

-ou-

path é prefixado com, ou contém, apenas um carácter dos dois-pontos (:).

path é null.

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

path contém um carácter de dois pontos (:) que não faz parte de uma etiqueta de drive ("C:\").

Exemplos

O exemplo seguinte cria e elimina o diretório especificado:

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        // Specify the directory you want to manipulate.
        string path = @"c:\MyDir";
        
        // Determine whether the directory exists.
        if (Directory.Exists(path))
        {
            Console.WriteLine("That path exists already.");
            return;
        }
        
        DirectoryInfo di;
        try
        {
            // Try to create the directory.
            di = Directory.CreateDirectory(path);
            Console.WriteLine("The directory was created successfully at {0}.", Directory.GetCreationTime(path));
        }
        catch (UnauthorizedAccessException e)
        {
            Console.WriteLine("The caller does not have the required permission to create `{0}`", path);
            return;
        }
        
        // Delete the directory.
        di.Delete();
        Console.WriteLine("The directory was deleted successfully.");
    }
}
open System.IO

// Specify the directory you want to manipulate.
let path = @"c:\MyDir"

try
    // Determine whether the directory exists.
    if Directory.Exists path then
        printfn "That path exists already."
    else
        // Try to create the directory.
        let di = Directory.CreateDirectory path
        printfn $"The directory was created successfully at {Directory.GetCreationTime path}."

        // Delete the directory.
        di.Delete()
        printfn "The directory was deleted successfully."
with e ->
    printfn $"The process failed: {e}"
Imports System.IO

Public Class Test
    Public Shared Sub Main()
        ' Specify the directory you want to manipulate.
        Dim path As String = "c:\MyDir"

        Try
            ' Determine whether the directory exists.
            If Directory.Exists(path) Then
                Console.WriteLine("That path exists already.")
                Return
            End If

            ' Try to create the directory.
            Dim di As DirectoryInfo = Directory.CreateDirectory(path)
            Console.WriteLine("The directory was created successfully at {0}.", Directory.GetCreationTime(path))

            ' Delete the directory.
            di.Delete()
            Console.WriteLine("The directory was deleted successfully.")

        Catch e As Exception
            Console.WriteLine("The process failed: {0}.", e.ToString())
        End Try
    End Sub
End Class

Para criar o diretório C:\Users\User1\Public\Html quando o diretório atual é C:\Users\User1, use qualquer uma das seguintes chamadas para garantir que a barra adicional é interpretada corretamente:

Directory.CreateDirectory("Public\Html")
Directory.CreateDirectory("\Users\User1\Public\Html")
Directory.CreateDirectory("c:\Users\User1\Public\Html")
Directory.CreateDirectory("Public\\Html");
Directory.CreateDirectory("\\Users\\User1\\Public\\Html");
Directory.CreateDirectory("c:\\Users\\User1\\Public\\Html");

Observações

Todos os diretórios especificados path em são criados, a menos que já existam ou que alguma parte de path seja inválida. Se o diretório já existir, este método não cria um novo diretório, mas devolve um DirectoryInfo objeto para o diretório existente.

O path parâmetro especifica um caminho de diretório, não um caminho de ficheiro.

Os espaços finais são removidos do final do path parâmetro antes de criar o diretório.

Podes criar um diretório num computador remoto, numa partilha à qual tens acesso de escrita. Os caminhos UNC são suportados; Por exemplo, pode especificar o seguinte para \\\\2009\\Archives\\December: em Visual Basic, e em C#.

Criar um diretório apenas com o carácter dos dois (:) não é suportado, e fará com que a NotSupportedException seja lançada.

Em sistemas Unix, usa uma barra diagonal (/) como separador de caminhos.

Ver também

Aplica-se a

CreateDirectory(String, UnixFileMode)

Origem:
Directory.cs
Origem:
Directory.cs
Origem:
Directory.cs
Origem:
Directory.cs
Origem:
Directory.cs

Cria todos os diretórios e subdiretórios no caminho especificado com as permissões especificadas, a menos que já existam.

public:
 static System::IO::DirectoryInfo ^ CreateDirectory(System::String ^ path, System::IO::UnixFileMode unixCreateMode);
[System.Runtime.Versioning.UnsupportedOSPlatform("windows")]
public static System.IO.DirectoryInfo CreateDirectory(string path, System.IO.UnixFileMode unixCreateMode);
[<System.Runtime.Versioning.UnsupportedOSPlatform("windows")>]
static member CreateDirectory : string * System.IO.UnixFileMode -> System.IO.DirectoryInfo
Public Shared Function CreateDirectory (path As String, unixCreateMode As UnixFileMode) As DirectoryInfo

Parâmetros

path
String

O diretório a criar.

unixCreateMode
UnixFileMode

Uma combinação bit a bit dos valores de enumeração que especifica o modo de ficheiro Unix usado para criar diretórios.

Devoluções

Um objeto que representa o diretório no caminho especificado. Este objeto é devolvido independentemente de já existir um diretório no caminho especificado.

Atributos

Exceções

path é uma cadeia de comprimento zero, ou contém um ou mais caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars() método.

path é null.

O modo de ficheiro é inválido.

O interlocutor não tem a permissão necessária.

O caminho especificado excede o comprimento máximo definido pelo sistema.

path é um ficheiro.

Um componente do path não é um diretório.

Aplica-se a

CreateDirectory(String, DirectorySecurity)

Cria todos os diretórios no caminho especificado, a menos que já existam, aplicando a segurança do Windows especificada.

public:
 static System::IO::DirectoryInfo ^ CreateDirectory(System::String ^ path, System::Security::AccessControl::DirectorySecurity ^ directorySecurity);
public static System.IO.DirectoryInfo CreateDirectory(string path, System.Security.AccessControl.DirectorySecurity directorySecurity);
static member CreateDirectory : string * System.Security.AccessControl.DirectorySecurity -> System.IO.DirectoryInfo
Public Shared Function CreateDirectory (path As String, directorySecurity As DirectorySecurity) As DirectoryInfo

Parâmetros

path
String

O diretório a criar.

directorySecurity
DirectorySecurity

O controlo de acesso a aplicar ao diretório.

Devoluções

Um objeto que representa o diretório no caminho especificado. Este objeto é devolvido independentemente de já existir um diretório no caminho especificado.

Exceções

O diretório especificado por path é um ficheiro.

-ou-

O nome da rede é desconhecido.

O interlocutor não tem a permissão necessária.

.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars() método.

-ou-

path é prefixado com, ou contém, apenas um carácter dos dois-pontos (:).

path é null.

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

path contém um carácter de dois pontos (:) que não faz parte de uma etiqueta de drive ("C:\").

Exemplos

O exemplo seguinte cria um novo diretório com regras de acesso para duas contas de utilizador.

using System;
using System.IO;
using System.Security.AccessControl;

partial class Program
{
    static void DirectorySecurityExample()
    {
        DirectorySecurity securityRules = new DirectorySecurity();
        securityRules.AddAccessRule(new FileSystemAccessRule(@"Domain\account1", FileSystemRights.Read, AccessControlType.Allow));
        securityRules.AddAccessRule(new FileSystemAccessRule(@"Domain\account2", FileSystemRights.FullControl, AccessControlType.Allow));

        DirectoryInfo di = Directory.CreateDirectory(@"C:\destination\NewDirectory", securityRules);
    }
}
open System.IO
open System.Security.AccessControl

let securityRules = DirectorySecurity()
securityRules.AddAccessRule(FileSystemAccessRule(@"Domain\account1", FileSystemRights.Read, AccessControlType.Allow))
securityRules.AddAccessRule(FileSystemAccessRule(@"Domain\account2", FileSystemRights.FullControl, AccessControlType.Allow))

let di = Directory.CreateDirectory(@"C:\destination\NewDirectory", securityRules)
Imports System.IO
Imports System.Security.AccessControl

Partial Class Program
    Shared Sub DirectorySecurityExample()

        Dim securityRules As DirectorySecurity = New DirectorySecurity()
        securityRules.AddAccessRule(New FileSystemAccessRule("Domain\account1", FileSystemRights.Read, AccessControlType.Allow))
        securityRules.AddAccessRule(New FileSystemAccessRule("Domain\account2", FileSystemRights.FullControl, AccessControlType.Allow))

        Dim di As DirectoryInfo = Directory.CreateDirectory("C:\destination\NewDirectory", securityRules)

    End Sub
End Class

Observações

Use este método de sobrecarga para criar um diretório com controlo de acesso, pelo que não há hipótese de o diretório ser acedido antes de a segurança ser aplicada.

Todos os diretórios especificados no path parâmetro são criados, a menos que já existam ou que alguma parte de path seja inválida. O path parâmetro especifica um caminho de diretório, não um caminho de ficheiro. Se o diretório já existir, este método não cria um novo diretório, mas devolve um DirectoryInfo objeto para o diretório existente.

Os espaços finais são removidos do final do path parâmetro antes de criar o diretório.

Podes criar um diretório num computador remoto, numa partilha à qual tens acesso de escrita. Os caminhos UNC são suportados; Por exemplo, pode especificar o seguinte para \\\\2009\\Archives\\December: em Visual Basic, e em C#.

Criar um diretório apenas com o carácter dos dois (:) não é suportado e provoca o lançamento de a NotSupportedException .

Aplica-se a