Directory Classe

Definição

public ref class Directory abstract sealed

public ref class Directory sealed

public static class Directory

public sealed class Directory

[System.Runtime.InteropServices.ComVisible(true)]
public static class Directory

type Directory = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type Directory = class

Public Class Directory

Public NotInheritable Class Directory

Herança

Object

Directory

Atributos

ComVisibleAttribute

Exemplos

O exemplo seguinte mostra como recuperar todos os ficheiros de texto de um diretório e movê-los para um novo diretório. Depois de os ficheiros serem movidos, deixam de existir no diretório original.

using System;
using System.IO;

partial class Example1
{
    static void TwoStringsExample()
    {
        string sourceDirectory = @"C:\current";
        string archiveDirectory = @"C:\archive";

        try
        {
            var txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt");

            foreach (string currentFile in txtFiles)
            {
                string fileName = currentFile.Substring(sourceDirectory.Length + 1);
                Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
            }
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }
}

open System.IO

let sourceDirectory = @"C:\current"
let archiveDirectory = @"C:\archive"

try
    let txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt")

    for currentFile in txtFiles do
        let fileName = currentFile.Substring(sourceDirectory.Length + 1)
        Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName))

with e ->
    printfn $"{e.Message}"

Imports System.IO

Partial Class Example1
    Shared Sub TwoStringExample()

        Dim sourceDirectory As String = "C:\current"
        Dim archiveDirectory As String = "C:\archive"

        Try
            Dim txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt")

            For Each currentFile As String In txtFiles
                Dim fileName = currentFile.Substring(sourceDirectory.Length + 1)
                Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName))
            Next
        Catch e As Exception
            Console.WriteLine(e.Message)
        End Try

    End Sub
End Class

O exemplo seguinte demonstra como usar o EnumerateFiles método para recuperar uma coleção de ficheiros de texto de um diretório e depois usar essa coleção numa consulta para encontrar todas as linhas que contêm "Exemplo".

using System;
using System.IO;
using System.Linq;

partial class Program
{
    static void EnumerateFilesExample()
    {
        string archiveDirectory = @"C:\archive";

        var files = from retrievedFile in Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories)
                    from line in File.ReadLines(retrievedFile)
                    where line.Contains("Example")
                    select new
                    {
                        File = retrievedFile,
                        Line = line
                    };

        foreach (var f in files)
        {
            Console.WriteLine("{0} contains {1}", f.File, f.Line);
        }

        Console.WriteLine("{0} lines found.", files.Count().ToString());
    }
}

open System.IO

let archiveDirectory = @"C:\archive"

let files = 
    query {
        for retrivedFile in Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories) do
        for line in File.ReadLines retrivedFile do
        where (line.Contains "file") 
        select 
            {| File = retrivedFile 
               Line = line |}
    }

for f in files do
    printfn $"{f.File} contains {f.Line}"
printfn "{Seq.length files} lines found."

Imports System.IO

Partial Class Program
    Shared Sub EnumerateFilesExample()

        Dim archiveDirectory As String = "C:\archive"

        Dim files = From retrievedFile In Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories)
                    From line In File.ReadLines(retrievedFile)
                    Where line.Contains("Example")
                    Select New With {.curFile = retrievedFile, .curLine = line}

        For Each f In files
            Console.WriteLine("{0} contains {1}", f.curFile, f.curLine)
        Next
        Console.WriteLine("{0} lines found.", files.Count.ToString())

    End Sub
End Class

O exemplo seguinte demonstra como mover um diretório e todos os seus ficheiros para um novo diretório. O diretório original deixa de existir depois de ter sido movido.

using System;
using System.IO;

partial class Program
{
    static void DirectoryMoveExample()
    {
        string sourceDirectory = @"C:\source";
        string destinationDirectory = @"C:\destination";

        try
        {
            Directory.Move(sourceDirectory, destinationDirectory);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }
}

open System.IO

let sourceDirectory = @"C:\source"
let destinationDirectory = @"C:\destination"

try
    Directory.Move(sourceDirectory, destinationDirectory)
with e ->
    printfn $"{e.Message}"

Imports System.IO

Partial Class Program
    Shared Sub DirectoryMoveExample()

        Dim sourceDirectory As String = "C:\source"
        Dim destinationDirectory As String = "C:\destination"

        Try
            Directory.Move(sourceDirectory, destinationDirectory)
        Catch e As Exception
            Console.WriteLine(e.Message)
        End Try

    End Sub
End Class

Observações

Use a Directory classe para operações típicas como copiar, mover, renomear, criar e eliminar diretórios.

• Para criar um diretório, use um dos CreateDirectory métodos.

• Para eliminar um diretório, use um dos Delete métodos.

• Para obter ou definir o diretório atual de uma aplicação, use o GetCurrentDirectory método ou SetCurrentDirectory .

• Para manipular DateTime informação relacionada com a criação, acesso e escrita de um diretório, utilize métodos como SetLastAccessTime e SetCreationTime.

Os métodos estáticos da Directory classe realizam verificações de segurança em todos os métodos. Se for reutilizar um objeto várias vezes, considere usar o método de instância correspondente, DirectoryInfo pois a verificação de segurança nem sempre será necessária.

Se estiver a realizar apenas uma ação relacionada com diretórios, pode ser mais eficiente usar um método estático Directory em vez de um método de instância correspondente DirectoryInfo . A maioria Directory dos métodos requer o caminho para o diretório que estás a manipular.

Nos membros que aceitam um caminho, o caminho pode referir-se a um ficheiro ou diretório. Pode usar um caminho completo, um caminho relativo ou um caminho de Convenção de Nomes Universal (UNC) para um nome de servidor e partilha. Por exemplo, todos os seguintes são caminhos aceitáveis:

• "c:\\MyDir" em C#, ou "c:\MyDir" no Visual Basic.

• "MyDir\\MySubdir" em C#, ou "MyDir\MySubDir" em Visual Basic.

• "\\\\MyServer\\MyShare" em C#, ou "\\MyServer\MyShare" no Visual Basic.

Por defeito, é concedido acesso total de leitura/escrita a novos diretórios a todos os utilizadores. No entanto, a aplicação deve ter a segurança correta para aceder a diretórios existentes.

Para exigir permissões para um diretório e todos os seus subdiretórios, termine a cadeia de caminho com o carácter separador de diretório. (Por exemplo, "C:\Temp\" concede acesso a C:\Temp\ e a todos os seus subdiretórios.) Para exigir permissões apenas para um diretório específico, termine a cadeia de caminho com um ponto. (Por exemplo, "C:\Temp\." concede acesso apenas a C:\Temp\, não aos seus subdiretórios.)

Em membros que aceitam um searchPattern parâmetro, a cadeia de pesquisa pode ser qualquer combinação de caracteres literais e dois caracteres curinga; * e ?. Este parâmetro não reconhece expressões regulares. Para mais informações, consulte o EnumerateDirectories(String, String) método ou qualquer outro método que utilize o searchPattern parâmetro.

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

Directory e DirectoryInfo não são suportados para uso em aplicações Windows Store. Para informações sobre como aceder a ficheiros e pastas nas aplicações Windows Store, veja Aceder a dados e ficheiros (Windows aplicações da Store).

Ver também

• DriveInfo
• File
• DirectoryInfo
• FileInfo
• FileSystemWatcher
• E/S de arquivo e fluxo
• Como: Ler texto de um arquivo
• Como: Gravar texto em um arquivo
• Como: Ler e gravar em um arquivo de dados recém-criado