Compartir vía


FileSystem.Dir Método

Definición

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
Source:
FileSystem.vb
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

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

Se aplica a

Dir(String, FileAttribute)

Source:
FileSystem.vb
Source:
FileSystem.vb
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);
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. 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

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

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

Se aplica a