Conteúdo

# Função Dir

Devolve o nome de um ficheiro, diretório, ou todos os ficheiros e diretórios de uma unidade ou de um diretório que corresponda ao caminho da procura.

### Sintaxe:

    Dir [(PathName As String [, Attributes As Integer])]

### Tipo de retorno:

Cadeia

### Parâmetros:

PathName: Qualquer expressão de cadeia de caracteres que especifique o caminho de pesquisa, o diretório ou o ficheiro. Este argumento só pode ser especificado na primeira vez que se chamar a função Dir. Se desejar, pode introduzir o caminho na notação URL.

Atributos: Qualquer expressão inteira que especifique atributos de ficheiros a nível de bits. A função Dir apenas devolve ficheiros ou diretórios que correspondam aos atributos especificados. É possível combinar vários atributos somando os valores dos mesmos:

0 : Ficheiros normais.

16 : Devolve apenas o nome do diretório.

Utilize este atributo para verificar se um ficheiro ou diretório existe ou para determinar todos os ficheiros e pastas dentro de um diretório específico.

Para verificar se um ficheiro existe, introduza o caminho completo e o nome do ficheiro. Se o nome do ficheiro ou diretório não existir, a função Dir devolve uma cadeia de texto de comprimento zero ("").

Para gerar a lista de todos os ficheiros existentes num diretório específico, siga estas instruções. A primeira vez que invocar a função Dir, especifique o caminho de procura completo para os ficheiros, por exemplo, "D:\Files\*.ods". Se o caminho estiver correto e a procura encontrar pelo menos um ficheiro, a função Dir devolve o nome do primeiro ficheiro que corresponda ao caminho da procura. Para devolver nomes de ficheiros adicionais que correspondam ao caminho, invoque Dir novamente, mas sem argumentos.

Para apenas devolver diretórios, utilize o parâmetro de atributo. O mesmo é aplicável se pretender determinar o nome de um volume (por exemplo, uma partição de uma unidade de disco rígido).

### Códigos de erro

5 Chamada de procedimento inválido

53 Ficheiro não encontrado

### Exemplo:

    Sub ExampleDir
    ' Mostra todos os ficheiros e diretórios
    Dim sPath As String
    Dim sDir As String, sValue As String
        sDir="Diretórios:"
        sPath = CurDir
        sValue = Dir$(sPath + getPathSeparator + "*",16)
        Do
            If sValue <> "." And sValue <> ".." Then
                If (GetAttr( sPath + getPathSeparator + sValue) And 16) >0 Then
                    ' Obtém os diretórios
                    sDir = sDir & chr(13) & sValue
                End If
            End If
            sValue = Dir$
        Loop Until sValue = ""
        MsgBox sDir,0,sPath
    End Sub

Tópicos relacionados

Função CurDir

Função CompatibilityMode()

Instrução Option VBASupport

Necessitamos da sua ajuda!