FileSystemProxy.GetFiles Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- SearchOption
- ReadOnlyCollection<T>
- Objetos (Visual Basic)
- Cómo: Buscar archivos con un modelo concreto en Visual Basic
- Cómo: Obtener la colección de archivos de un directorio en Visual Basic
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
- ReadOnlyCollection<T>
- Objetos (Visual Basic)
- Cómo: Buscar archivos con un modelo concreto en Visual Basic
- Cómo: Obtener la colección de archivos de un directorio en Visual Basic
