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

Artículo
08/23/2008

Actualización: noviembre 2007

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos de un directorio.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parámetros

directory
String. Directorio en el que se va a buscar. Obligatorio.
searchType
SearchOption (Enumeración). Si se han de incluir las subcarpetas. El valor predeterminado es SearchOption.SearchTopLevelOnly. Obligatorio.
wildcards
String. Modelo que hacer coincidir. Obligatorio.

Valor devuelto

Colección de sólo lectura de cadenas.

Excepciones

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

Comentarios

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

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.FileSystem.GetFiles.

Para	Vea
Obtener la colección de archivos contenidos en un directorio	Cómo: Obtener la colección de archivos de un directorio en Visual Basic
Buscar archivos con un modelo concreto en un directorio	Cómo: Buscar archivos con un modelo específico en Visual Basic

Ejemplo

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 requiere que se tenga un control ListBox denominado ListBox1 en el formulario.

Este ejemplo devuelve todos los archivos situados en el directorio que tienen la extensión .dll y los agrega a ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
      (My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
       FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Este ejemplo requiere que se tenga un control ListBox denominado ListBox1 en el formulario.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	Sí
Servicio de Windows	Sí
Sitio Web	Sí