Directory.CreateDirectory Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 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 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 .