Compartir a través de


FileSystemProxy.GetFiles Método

Definición

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

Sobrecargas

GetFiles(String, SearchOption, String[])

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

GetFiles(String)

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

GetFiles(String, SearchOption, String[])

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Parámetros

directory
String

Directorio en el que se va a buscar.

searchType
SearchOption

Indica si se van a incluir las subcarpetas. El valor predeterminado es SearchOption.SearchTopLevelOnly.

wildcards
String[]

Modelo con el que hay que coincidir.

Devoluciones

Colección de solo lectura de los nombres de archivo del directorio especificado.

Excepciones

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\).

directory es Nothing.

El directorio que se desea buscar no existe.

directory señala a un archivo existente.

La ruta de acceso supera la longitud máxima definida por el sistema.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

El usuario no tiene los permisos necesarios.

Ejemplos

En el siguiente ejemplo se devuelven todos los archivos contenidos en el directorio y se agregan a ListBox1.

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

Este ejemplo requiere que tenga un ListBox nombre ListBox1 en el formulario.

En este ejemplo se devuelven todos los archivos del directorio con la extensión .txt y se agregan 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 tenga un ListBox nombre ListBox1 en el formulario.

Comentarios

Si no se encuentran archivos que coincidan con el patrón especificado, se devuelve una colección vacía.

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.GetFiles método .

En Vea
Obtención de la colección de archivos en un directorio Procedimiento para obtener la colección de archivos de un directorio
Búsqueda de archivos con un patrón específico en un directorio Procedimiento para buscar archivos con un patrón concreto

Consulte también

Se aplica a

GetFiles(String)

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Parámetros

directory
String

Directorio en el que se va a buscar.

Devoluciones

Colección de solo lectura de los nombres de archivo del directorio especificado.

Excepciones

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\).

directory es Nothing.

El directorio que se desea buscar no existe.

directory señala a un archivo existente.

La ruta de acceso supera la longitud máxima definida por el sistema.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

El usuario no tiene los permisos necesarios.

Ejemplos

En el siguiente ejemplo se devuelven todos los archivos contenidos en el directorio y se agregan a ListBox1.

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

Este ejemplo requiere que tenga un ListBox nombre ListBox1 en el formulario.

En este ejemplo se devuelven todos los archivos del directorio con la extensión .txt y se agregan 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 tenga un ListBox nombre ListBox1 en el formulario.

Comentarios

Si no se encuentran archivos que coincidan con el patrón especificado, se devuelve una colección vacía.

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.GetFiles método .

En Vea
Obtención de la colección de archivos en un directorio Procedimiento para obtener la colección de archivos de un directorio
Búsqueda de archivos con un patrón específico en un directorio Procedimiento para buscar archivos con un patrón concreto

Consulte también

Se aplica a