Partilhar via


FileSystem.Dir Método

Definição

Retorna uma cadeia de caracteres que representa o nome de um arquivo, diretório ou pasta que corresponde a um padrão ou atributo de arquivo especificado ou o rótulo de volume de uma unidade. O FileSystem oferece maior produtividade e desempenho em operações de E/S de arquivo do que a função Dir. Consulte GetDirectoryInfo(String) para obter mais informações.

Sobrecargas

Dir()

Retorna uma cadeia de caracteres que representa o nome de um arquivo, diretório ou pasta que corresponde a um padrão ou atributo de arquivo especificado ou o rótulo de volume de uma unidade. O FileSystem oferece maior produtividade e desempenho em operações de E/S de arquivo do que a função Dir. Consulte GetDirectoryInfo(String) para obter mais informações.

Dir(String, FileAttribute)

Retorna uma cadeia de caracteres que representa o nome de um arquivo, diretório ou pasta que corresponde a um padrão ou atributo de arquivo especificado ou o rótulo de volume de uma unidade. O FileSystem oferece maior produtividade e desempenho em operações de E/S de arquivo do que a função Dir. Consulte GetDirectoryInfo(String) para obter mais informações.

Dir()

Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna uma cadeia de caracteres que representa o nome de um arquivo, diretório ou pasta que corresponde a um padrão ou atributo de arquivo especificado ou o rótulo de volume de uma unidade. O FileSystem oferece maior produtividade e desempenho em operações de E/S de arquivo do que a função Dir. Consulte GetDirectoryInfo(String) para obter mais informações.

public:
 static System::String ^ Dir();
public static string Dir ();
static member Dir : unit -> string
Public Function Dir () As String

Retornos

Uma cadeia de caracteres representando o nome de um arquivo, diretório ou pasta correspondente a um padrão especificado ou atributo de arquivo ou o rótulo de volume de uma unidade.

Exemplos

Este exemplo usa a Dir função para verificar se determinados arquivos e diretórios existem.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" if it exists.
MyFile = Dir("C:\WINDOWS\WIN.INI")

' Returns filename with specified extension. If more than one *.INI
' file exists, the first file found is returned.
MyFile = Dir("C:\WINDOWS\*.INI")

' Call Dir again without arguments to return the next *.INI file in the
' same directory.
MyFile = Dir()

' Return first *.TXT file, including files with a set hidden attribute.
MyFile = Dir("*.TXT", vbHidden)

' Display the names in C:\ that represent directories.
MyPath = "c:\"   ' Set the path.
MyName = Dir(MyPath, vbDirectory)   ' Retrieve the first entry.
Do While MyName <> ""   ' Start the loop.
    ' Use bitwise comparison to make sure MyName is a directory.
    If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
        ' Display entry only if it's a directory.
        MsgBox(MyName)
    End If
    MyName = Dir()   ' Get next entry.
Loop

Comentários

A Dir função dá suporte ao uso de caracteres curinga (*) e caractere único (?) para especificar vários arquivos.

VbVolume retorna o rótulo de volume da unidade em vez de um nome de arquivo específico.

Você deve fornecer uma PathName primeira vez que chamar a Dir função. Para recuperar o próximo item, você pode fazer chamadas subsequentes para a Dir função sem parâmetros.

Importante

Para ser executada corretamente, a Dir função exige que os Read sinalizadores e PathDiscovery de FileIOPermission sejam concedidos ao código em execução. Para obter mais informações, consulte FileIOPermission, SecurityExceptione Permissões de acesso ao código.

Os Attributes valores de enumeração de argumento são os seguintes:

Valor Constante Descrição
Normal vbnormal Padrão. Especifica arquivos sem atributos.
ReadOnly vbReadOnly Especifica arquivos somente leitura e também arquivos sem atributos.
Hidden vbHidden Especifica arquivos ocultos e também arquivos sem atributos.
System vbSystem Especifica arquivos do sistema e também arquivos sem atributos.
Volume vbVolume Especifica o rótulo de volume; se qualquer outro atributo for especificado, vbVolume será ignorado.
Directory vbDirectory Especifica diretórios ou pastas e também arquivos sem atributos.
Archive vbArchive O arquivo foi alterado desde o último backup.
Alias vbAlias O arquivo tem um nome diferente.

Observação

Essas enumerações são especificadas pela linguagem Visual Basic e podem ser usadas em qualquer lugar do código, em vez dos valores reais.

Confira também

Aplica-se a

Dir(String, FileAttribute)

Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna uma cadeia de caracteres que representa o nome de um arquivo, diretório ou pasta que corresponde a um padrão ou atributo de arquivo especificado ou o rótulo de volume de uma unidade. O FileSystem oferece maior produtividade e desempenho em operações de E/S de arquivo do que a função Dir. Consulte GetDirectoryInfo(String) para obter mais informações.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
public static string Dir (string Pathname, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String
Public Function Dir (Pathname As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

Parâmetros

PathNamePathname
String

Opcional. Uma expressão de cadeia de caracteres que especifica um nome de arquivo, diretório ou pasta ou um rótulo de volume de unidade. Uma cadeia de caracteres de comprimento zero ("") será retornada se PathName não for encontrado.

Attributes
FileAttribute

Opcional. Enumeração ou expressão numérica cujo valor especifica atributos de arquivo. Se omitido, Dir retorna arquivos que correspondem a Pathname, mas não têm atributos.

Retornos

Uma cadeia de caracteres representando o nome de um arquivo, diretório ou pasta correspondente a um padrão especificado ou atributo de arquivo ou o rótulo de volume de uma unidade.

Atributos

Exemplos

Este exemplo usa a Dir função para verificar se determinados arquivos e diretórios existem.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" if it exists.
MyFile = Dir("C:\WINDOWS\WIN.INI")

' Returns filename with specified extension. If more than one *.INI
' file exists, the first file found is returned.
MyFile = Dir("C:\WINDOWS\*.INI")

' Call Dir again without arguments to return the next *.INI file in the
' same directory.
MyFile = Dir()

' Return first *.TXT file, including files with a set hidden attribute.
MyFile = Dir("*.TXT", vbHidden)

' Display the names in C:\ that represent directories.
MyPath = "c:\"   ' Set the path.
MyName = Dir(MyPath, vbDirectory)   ' Retrieve the first entry.
Do While MyName <> ""   ' Start the loop.
    ' Use bitwise comparison to make sure MyName is a directory.
    If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
        ' Display entry only if it's a directory.
        MsgBox(MyName)
    End If
    MyName = Dir()   ' Get next entry.
Loop

Comentários

A Dir função dá suporte ao uso de caracteres curinga (*) e caractere único (?) para especificar vários arquivos.
VbVolume retorna o rótulo de volume da unidade em vez de um nome de arquivo específico.
Você deve fornecer uma PathName primeira vez que chamar a Dir função. Para recuperar o próximo item, você pode fazer chamadas subsequentes para a Dir função sem parâmetros.

Importante

Para ser executada corretamente, a Dir função exige que os Read sinalizadores e PathDiscovery de FileIOPermission sejam concedidos ao código em execução. Para obter mais informações, consulte FileIOPermission, SecurityExceptione Permissões de acesso ao código.
Os Attributes valores de enumeração de argumento são os seguintes:
|Valor|Constante|Descrição|
|-|-|-|
| Normal | vbnormal|Padrão. Especifica arquivos que não têm atributos.|
| ReadOnly | vbReadOnly|Especifica arquivos somente leitura, além de arquivos que não têm atributos.|
| Hidden | vbHidden|Especifica arquivos ocultos, além de arquivos que não têm atributos.|
| System | vbSystem|Especifica arquivos do sistema, além de arquivos que não têm atributos.|
| Volume | vbVolume|Especifica o rótulo de volume; se qualquer outro atributo for especificado, vbVolume será ignorado.|
| Directory | vbDirectory|Especifica diretórios ou pastas, além de arquivos que não têm atributos.|
| Archive | vbArchive|O arquivo foi alterado desde o último backup.|
| Alias | vbAlias|O arquivo tem um nome diferente.|

Observação

Essas enumerações são especificadas pela linguagem Visual Basic e podem ser usadas em qualquer lugar do código no lugar dos valores reais.

Confira também

Aplica-se a