FileSystem.Dir Método

public:
 static System::String ^ Dir();

public static string Dir();

static member Dir : unit -> string

Public Function Dir () As String

Devoluções

Uma string que representa o nome de um ficheiro, diretório ou pasta que corresponde a um padrão ou atributo de ficheiro especificado, ou ao rótulo de volume de uma unidade.

Exemplos

Este exemplo utiliza a Dir função para verificar se certos ficheiros 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

Observações

A Dir função suporta o uso de curingas de múltiplos caracteres (*) e de um único carácter (?) para especificar múltiplos ficheiros.

VbVolume devolve a etiqueta de volume da unidade em vez de um nome de ficheiro específico.

Deve fornecer um PathName na primeira vez que chamar o Dir evento. Para recuperar o item seguinte, pode fazer chamadas subsequentes à Dir função sem parâmetros.

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

Ver também

• ChDir(String)
• ChDrive
• FileAttribute

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

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

Devoluções

Uma string que representa o nome de um ficheiro, diretório ou pasta que corresponde a um padrão ou atributo de ficheiro especificado, ou ao rótulo de volume de uma unidade.

Exemplos

Este exemplo utiliza a Dir função para verificar se certos ficheiros 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

Observações

A Dir função suporta o uso de curingas de múltiplos caracteres (*) e de um único carácter (?) para especificar múltiplos ficheiros. VbVolume devolve a etiqueta de volume da unidade em vez de um nome de ficheiro específico. Deve fornecer um PathName na primeira vez que chamar o Dir evento. Para recuperar o item seguinte, pode fazer chamadas subsequentes à Dir função sem parâmetros.

Ver também

• ChDir(String)
• ChDrive
• FileAttribute