FileSystem.Dir Método

Definición

Espacio de nombres:: Microsoft.VisualBasic

Ensamblado:: Microsoft.VisualBasic.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve una cadena que representa el nombre de un archivo, directorio o carpeta que coincide con un patrón o atributo de archivo especificado, o la etiqueta de volumen de una unidad. FileSystem proporciona una mayor productividad y rendimiento en las operaciones de E/S de archivos que la Dir función . Consulte GetDirectoryInfo(String) para obtener más información.

Sobrecargas

Nombre	Description
Dir()	Devuelve una cadena que representa el nombre de un archivo, directorio o carpeta que coincide con un patrón o atributo de archivo especificado, o la etiqueta de volumen de una unidad. FileSystem proporciona una mayor productividad y rendimiento en las operaciones de E/S de archivos que la `Dir` función . Consulte GetDirectoryInfo(String) para obtener más información.
Dir(String, FileAttribute)	Devuelve una cadena que representa el nombre de un archivo, directorio o carpeta que coincide con un patrón o atributo de archivo especificado, o la etiqueta de volumen de una unidad. FileSystem proporciona una mayor productividad y rendimiento en las operaciones de E/S de archivos que la `Dir` función . Consulte GetDirectoryInfo(String) para obtener más información.

Dir()

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

public static string Dir();

static member Dir : unit -> string

Public Function Dir () As String

Devoluciones

String

Cadena que representa el nombre de un archivo, directorio o carpeta que coincide con un patrón o atributo de archivo especificado, o la etiqueta de volumen de una unidad.

Ejemplos

En este ejemplo se usa la Dir función para comprobar si existen determinados archivos y directorios.

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

Comentarios

La Dir función admite el uso de caracteres comodín de varios caracteres (*) y de un solo carácter (?) para especificar varios archivos.

VbVolume devuelve la etiqueta de volumen de la unidad en lugar de un nombre de archivo específico.

Debe proporcionar la PathName primera vez que llame a la Dir función . Para recuperar el siguiente elemento, puede realizar llamadas posteriores a la Dir función sin parámetros.

Importante

Los Attributes valores de enumeración de argumentos son los siguientes:

Value	Constante	Description
`Normal`	`vbnormal`	Predeterminada. Especifica archivos sin atributos.
`ReadOnly`	`vbReadOnly`	Especifica archivos de solo lectura y también archivos sin atributos.
`Hidden`	`vbHidden`	Especifica archivos ocultos y también archivos sin atributos.
`System`	`vbSystem`	Especifica los archivos del sistema y también los archivos sin atributos.
`Volume`	`vbVolume`	Especifica la etiqueta de volumen; si se especifica cualquier otro atributo, `vbVolume` se omite.
`Directory`	`vbDirectory`	Especifica directorios o carpetas y también archivos sin atributos.
`Archive`	`vbArchive`	El archivo ha cambiado desde la última copia de seguridad.
`Alias`	`vbAlias`	El archivo tiene un nombre diferente.

Nota:

Estas enumeraciones se especifican mediante el lenguaje Visual Basic y se pueden usar en cualquier lugar del código en lugar de los valores reales.

Consulte también

Se aplica a

Dir(String, 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

PathnamePathName: String

Optional. Expresión de cadena que especifica un nombre de archivo, un directorio o un nombre de carpeta o etiqueta de volumen de unidad. Si no se encuentra, se devuelve Pathname una cadena de longitud cero ("").

Attributes: FileAttribute

Optional. Enumeración o expresión numérica cuyo valor especifica atributos de archivo. Si se omite, Dir devuelve los archivos que coinciden Pathname , pero que no tienen atributos.

Devoluciones

String

Cadena que representa el nombre de un archivo, directorio o carpeta que coincide con un patrón o atributo de archivo especificado, o la etiqueta de volumen de una unidad.

Ejemplos

En este ejemplo se usa la Dir función para comprobar si existen determinados archivos y directorios.

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

Comentarios

La Dir función admite el uso de caracteres comodín de varios caracteres (*) y de un solo carácter (?) para especificar varios archivos. VbVolume devuelve la etiqueta de volumen de la unidad en lugar de un nombre de archivo específico. Debe proporcionar la PathName primera vez que llame a la Dir función . Para recuperar el siguiente elemento, puede realizar llamadas posteriores a la Dir función sin parámetros.

Importante

Nota:

Estas enumeraciones se especifican mediante el lenguaje Visual Basic y se pueden usar en cualquier lugar del código en lugar de los valores reales.

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?