FileSystem.Dir Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

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

Sobrecargas

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

Dir()

Source:

FileSystem.vb

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

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

public static string Dir ();

static member Dir : unit -> string

Public Function Dir () As String

Devoluciones

String

Una cadena que representa el nombre de un archivo, un directorio o una carpeta que coincide con un atributo de archivo o modelo 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

Para ejecutarse correctamente, la Dir función requiere que se concedan las Read marcas FileIOPermission y PathDiscovery al código en ejecución. Para obtener más información, vea FileIOPermissionPermisos de acceso a código SecurityException, y .

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

Valor	Constante	Descripción
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 que se realizó la última copia de seguridad.
Alias	vbAlias	El archivo tiene un nombre diferente.

Nota

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

Consulte también

• ChDir(String)
• ChDrive
• FileAttribute

Dir(String, FileAttribute)

Source:

FileSystem.vb

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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

Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

Parámetros

PathName

String

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

Attributes

FileAttribute

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

Devoluciones

String

Una cadena que representa el nombre de un archivo, un directorio o una carpeta que coincide con un atributo de archivo o modelo especificado, o la etiqueta de volumen de una unidad.

Atributos

SupportedOSPlatformAttribute

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

Para ejecutarse correctamente, la Dir función requiere que se concedan las Read marcas FileIOPermission y PathDiscovery al código en ejecución. Para obtener más información, vea FileIOPermissionPermisos de acceso a código SecurityException, y .
Los Attributes valores de enumeración de argumentos son los siguientes:
|Valor |Constante |Descripción|
|-|-|-|
| Normal | vbnormal|Predeterminado. Especifica los archivos que no tienen atributos.|
| ReadOnly | vbReadOnly|Especifica los archivos de solo lectura, además de los archivos que no tienen atributos.|
| Hidden | vbHidden|Especifica los archivos ocultos, además de los archivos que no tienen atributos.|
| System | vbSystem|Especifica los archivos del sistema, además de los archivos que no tienen atributos.|
| Volume | vbVolume|Especifica la etiqueta de volumen; si se especifica cualquier otro atributo, vbVolume se omite.|
| Directory | vbDirectory|Especifica directorios o carpetas, además de los archivos que no tienen 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 de Visual Basic y se pueden usar en cualquier lugar del código en lugar de los valores reales.

Consulte también

• ChDir(String)
• ChDrive
• FileAttribute