Compartir a través de


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

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

Biblioteca de clases

Aplicación de consola

Biblioteca de controles de Windows

Biblioteca de controles Web

Servicio de Windows

Sitio Web

Permisos

El permiso siguiente puede ser necesario:

Permiso

Descripción

FileIOPermission

Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

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

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

Referencia

My.Computer.FileSystem (Objeto)

SearchOption (Enumeración)

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetFiles