Cómo: Obtener la colección de archivos de un directorio en Visual Basic

  • Artículo

Actualización: noviembre 2007

El My.Computer.FileSystem.GetFiles (Método) devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos contenidos en un directorio. Puede utilizar el parámetro wildCards para especificar un modelo concreto. Para incluir los subdirectorios en la búsqueda, establezca el parámetro searchType en SearchOption.SearchAllSubDirectories.

Se devuelve una colección vacía si no se encuentra ningún archivo que coincida con el modelo especificado.

Para mostrar una lista de los archivos existentes en un directorio

  • Utilice el método GetFiles, proporcionando el nombre y ruta de acceso del directorio en el que buscar. El ejemplo siguiente devuelve todos los archivos contenidos en el directorio y los agrega a ListBox1.

    For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    listBox1.Items.Add(foundFile)
Next

    Este ejemplo de código también está disponible como fragmento de código de IntelliSense. En el selector de fragmentos de código, se encuentra en Sistema de archivos - Procesando unidades, carpetas y archivos. Para obtener más información, vea Cómo: Insertar fragmentos de código en el código (Visual Basic).

Programación eficaz

Las condiciones siguientes pueden producir una excepción:

  • La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero, sólo contiene un espacio en blanco, contiene caracteres no válidos o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).

  • La ruta de acceso no es válida porque es Nothing (ArgumentNullException).

  • directory no existe (DirectoryNotFoundException).

  • directory señala a un archivo existente (IOException).

  • La ruta supera la longitud máxima definida por el sistema (PathTooLongException).

  • Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).

  • El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).

  • El usuario no tiene los permisos necesarios (UnauthorizedAccessException).

Vea también

Tareas

Cómo: Buscar archivos con un modelo específico en Visual Basic

Cómo: Buscar subdirectorios con un modelo específico en Visual Basic

Referencia

My.Computer.FileSystem.GetFiles (Método)