DirectoryInfo.CreateSubdirectory Método

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.FileSystem.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.FileSystem.dll

Assemblagem:: netstandard.dll

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

Sobrecargas

Name	Description
CreateSubdirectory(String)	Cria um subdiretório ou subdiretórios no caminho especificado. O caminho especificado pode ser relativo a esta instância da DirectoryInfo classe.
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 DirectoryInfo classe.

CreateSubdirectory(String)

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

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. Isto não pode ser um volume de disco diferente ou um nome de Convenção Universal de Nomes (UNC).

Devoluções

DirectoryInfo

O último diretório especificado em path.

Exceções

ArgumentException

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

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido, como se estivesse num disco não mapeado.

IOException

O subdiretório não pode ser criado.

-ou-

Um ficheiro já tem o nome especificado por path.

PathTooLongException

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

SecurityException

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

-ou-

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

NotSupportedException

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

Exemplos

O exemplo seguinte 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 apagamento no código.

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)
            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

Observações

Todos os diretórios especificados path em são criados, a menos 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 subdiretório já existir, este método não faz nada.

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

Ver 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 DirectoryInfo classe.

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. Isto não pode ser um volume de disco diferente ou um nome de Convenção Universal de Nomes (UNC).

directorySecurity: DirectorySecurity

A segurança para se candidatar.

Devoluções

DirectoryInfo

O último diretório especificado em path.

Exceções

ArgumentException

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

ArgumentNullException

path é null.

DirectoryNotFoundException

O caminho especificado é inválido, como se estivesse num disco não mapeado.

IOException

O subdiretório não pode ser criado.

-ou-

Um ficheiro ou diretório já tem o nome especificado por path.

PathTooLongException

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

SecurityException

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

-ou-

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

NotSupportedException

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

Observações

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

Aplica-se a

Comentários

Esta página foi útil?