My.Computer.FileSystem.GetDirectories (Método)
Actualización: noviembre 2007
Devuelve una colección de cadenas que representa los nombres de las rutas de acceso de los subdirectorios de un directorio.
' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards)
' Declaration
Public Function GetDirectories( _
ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetDirectories( _
ByVal directory As String, _
ByVal searchType As SearchOption, _
ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
Parámetros
directory
String. Nombre y ruta de acceso de directorio. Obligatorio.searchType
SearchOption (Enumeración). Si se han de incluir las subcarpetas. El valor predeterminado es SearchOption.SearchTopLevelOnly. Obligatorio.wildcards
String. Modelo con el que hacer coincidir los nombres. Obligatorio.
Valor devuelto
Colección de sólo lectura de String.
Excepciones
Las condiciones siguientes pueden provocar 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).
Uno o más de los caracteres comodín especificados es Nothing, una cadena vacía, o contiene sólo espacios (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
Puede utilizar el parámetro wildcards para especificar un modelo concreto. Si desea incluir el contenido de subdirectorios en la búsqueda, establezca el parámetro searchType en SearchAllSubDirectories.
Si no se encuentra ningún directorio que coincida con el modelo especificado, se devuelve una colección vacía.
Tareas
La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.FileSystem.GetDirectories.
Para |
Vea |
---|---|
Mostrar los subdirectorios que siguen un modelo concreto |
Cómo: Buscar subdirectorios con un modelo específico en Visual Basic |
Ejemplo
El ejemplo siguiente devuelve todos los directorios de la estructura de directorios que contienen la palabra Logs en sus nombres y los agrega a ListBox1.
For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
ListBox1.Items.Add(foundDirectory)
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í |
Permisos
El permiso siguiente puede ser necesario:
Permiso |
Descripción |
---|---|
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
Referencia
My.Computer.FileSystem (Objeto)