DirectoryInfo(String) Construtor

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assemblagem:
System.IO.FileSystem.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
DirectoryInfo.cs
Origem:
DirectoryInfo.cs
Origem:
DirectoryInfo.cs
Origem:
DirectoryInfo.cs
Origem:
DirectoryInfo.cs

Inicializa uma nova instância da DirectoryInfo classe no caminho especificado.

public:
 DirectoryInfo(System::String ^ path);
public DirectoryInfo(string path);
new System.IO.DirectoryInfo : string -> System.IO.DirectoryInfo
Public Sub New (path As String)

Parâmetros

path
String

Uma cadeia que especifica o caminho para criar o DirectoryInfo.

Exceções

ArgumentNullException

path é null.

SecurityException

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

ArgumentException

.NET As versões Framework e .NET Core anteriores à 2.1: path contém caracteres inválidos como ", <, > ou |.

PathTooLongException

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

Exemplos

O exemplo seguinte usa este construtor para criar o diretório e subdiretório especificados, e demonstra que um diretório que contém subdiretórios não pode ser eliminado.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        // Specify the directories you want to manipulate.
        DirectoryInfo di1 = new DirectoryInfo(@"c:\MyDir");
        DirectoryInfo di2 = new DirectoryInfo(@"c:\MyDir\temp");

        try
        {
            // Create the directories.
            di1.Create();
            di2.Create();

            // This operation will not be allowed because there are subdirectories.
            Console.WriteLine("I am about to attempt to delete {0}.", di1.Name);
            di1.Delete();
            Console.WriteLine("The Delete operation was successful, which was unexpected.");
        }
        catch (Exception)
        {
            Console.WriteLine("The Delete operation failed as expected.");
        }
        finally {}
    }
}

open System.IO

// Specify the directories you want to manipulate.
let di1 = DirectoryInfo @"c:\MyDir"
let di2 = DirectoryInfo @"c:\MyDir\temp"

try
    // Create the directories.
    di1.Create()
    di2.Create()

    // This operation will not be allowed because there are subdirectories.
    printfn $"I am about to attempt to delete {di1.Name}."
    di1.Delete()
    printfn "The Delete operation was successful, which was unexpected."
with _ ->
    printfn "The Delete operation failed as expected."

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        ' Specify the directories you want to manipulate.
        Dim di1 As DirectoryInfo = New DirectoryInfo("c:\MyDir")
        Dim di2 As DirectoryInfo = New DirectoryInfo("c:\MyDir\temp")
        Try
            ' Create the directories.
            di1.Create()
            di2.Create()
            ' This operation will not be allowed because there are subdirectories.
            Console.WriteLine("I am about to attempt to delete {0}.", di1.Name)
            di1.Delete()
            Console.WriteLine("The Delete operation was successful, which was unexpected.")
        Catch e As Exception
            Console.WriteLine("The Delete operation failed as expected.")
        End Try
    End Sub
End Class

Observações

Este construtor não verifica se existe um diretório. Este construtor é um marcador de posição para uma cadeia que é usada para aceder ao disco em operações subsequentes.

O path parâmetro pode ser um nome de ficheiro, incluindo um ficheiro numa partilha da Convenção Universal de Nomes (UNC).

Atenção

Quando se compila um conjunto de personagens com um determinado cenário cultural e se recuperam essas mesmas personagens com um cenário cultural diferente, as personagens podem não ser interpretáveis e podem causar uma exceção.

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

Aplica-se a

Ver também