FileSystemProxy.GetFiles FileSystemProxy.GetFiles FileSystemProxy.GetFiles FileSystemProxy.GetFiles Method

Definición

Devuelve una colección de cadenas de sólo lectura que representan los nombres de los archivos de un directorio.Returns a read-only collection of strings representing the names of files within a directory.

Sobrecargas

GetFiles(String, SearchOption, String[]) GetFiles(String, SearchOption, String[]) GetFiles(String, SearchOption, String[]) GetFiles(String, SearchOption, String[])

Devuelve una colección de cadenas de sólo lectura que representan los nombres de los archivos de un directorio.Returns a read-only collection of strings representing the names of files within a directory.

GetFiles(String) GetFiles(String) GetFiles(String) GetFiles(String)

Devuelve una colección de cadenas de sólo lectura que representan los nombres de los archivos de un directorio.Returns a read-only collection of strings representing the names of files within a directory.

GetFiles(String, SearchOption, String[]) GetFiles(String, SearchOption, String[]) GetFiles(String, SearchOption, String[]) GetFiles(String, SearchOption, String[])

Devuelve una colección de cadenas de sólo lectura que representan los nombres de los archivos de un directorio.Returns a read-only collection of strings representing the names of files within a directory.

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 String String String

Directorio en el que se va a buscar.Directory to be searched.

searchType
SearchOption SearchOption SearchOption SearchOption

Indica si se van a incluir las subcarpetas.Whether to include subfolders. El valor predeterminado es SearchOption.SearchTopLevelOnly.Default is SearchOption.SearchTopLevelOnly.

wildcards
String[]

Modelo con el que hay que coincidir.Pattern to be matched.

Devoluciones

Colección de solo lectura de los nombres de archivo del directorio especificado.Read-only collection of file names from the specified directory.

Excepciones

La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

El directorio que se desea buscar no existe.The directory to search does not exist.

directory señala a un archivo existente.directory points to an existing file.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.A file or directory name in the path contains a colon (:) or is in an invalid format.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene los permisos necesarios.The user lacks necessary permissions.

Ejemplos

En el siguiente ejemplo se devuelven todos los archivos contenidos en el directorio y se agregan a ListBox1.The following example returns all files in the directory and adds them to 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 denominado ListBox1 en el formulario.This example requires that you have a ListBox named ListBox1 on your form.

En este ejemplo se devuelven todos los archivos del .txt directorio con la extensión ListBox1y se agregan a.This example returns all files in the directory with the extension .txt and adds them to 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 denominado ListBox1 en el formulario.This example requires that you have a ListBox named ListBox1 on your form.

Comentarios

Si no se encuentran archivos que coincidan con el patrón especificado, se devuelve una colección vacía.An empty collection is returned if no files matching the specified pattern are found.

En la tabla siguiente se muestran ejemplos de tareas que My.Computer.FileSystem.GetFiles implican el método.The following table lists examples of tasks involving the My.Computer.FileSystem.GetFiles method.

EnTo VeaSee
Obtener la colección de archivos de un directorioGet the collection of files in a directory Obtener la colección de archivos de un directorioHow to: Get the Collection of Files in a Directory
Buscar archivos con un patrón específico en un directorioFind files with a specific pattern in a directory Buscar archivos con un modelo concretoHow to: Find Files with a Specific Pattern

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

Consulte también:

GetFiles(String) GetFiles(String) GetFiles(String) GetFiles(String)

Devuelve una colección de cadenas de sólo lectura que representan los nombres de los archivos de un directorio.Returns a read-only collection of strings representing the names of files within a directory.

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 String String String

Directorio en el que se va a buscar.Directory to be searched.

Devoluciones

Colección de solo lectura de los nombres de archivo del directorio especificado.Read-only collection of file names from the specified directory.

Excepciones

La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

El directorio que se desea buscar no existe.The directory to search does not exist.

directory señala a un archivo existente.directory points to an existing file.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.A file or directory name in the path contains a colon (:) or is in an invalid format.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene los permisos necesarios.The user lacks necessary permissions.

Ejemplos

En el siguiente ejemplo se devuelven todos los archivos contenidos en el directorio y se agregan a ListBox1.The following example returns all files in the directory and adds them to 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 denominado ListBox1 en el formulario.This example requires that you have a ListBox named ListBox1 on your form.

En este ejemplo se devuelven todos los archivos del .txt directorio con la extensión ListBox1y se agregan a.This example returns all files in the directory with the extension .txt and adds them to 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 denominado ListBox1 en el formulario.This example requires that you have a ListBox named ListBox1 on your form.

Comentarios

Si no se encuentran archivos que coincidan con el patrón especificado, se devuelve una colección vacía.An empty collection is returned if no files matching the specified pattern are found.

En la tabla siguiente se muestran ejemplos de tareas que My.Computer.FileSystem.GetFiles implican el método.The following table lists examples of tasks involving the My.Computer.FileSystem.GetFiles method.

EnTo VeaSee
Obtener la colección de archivos de un directorioGet the collection of files in a directory Obtener la colección de archivos de un directorioHow to: Get the Collection of Files in a Directory
Buscar archivos con un patrón específico en un directorioFind files with a specific pattern in a directory Buscar archivos con un modelo concretoHow to: Find Files with a Specific Pattern

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

Consulte también:

Se aplica a