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.

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

Permisos

El permiso siguiente puede ser necesario:

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

Vea también

Referencia

My.Computer.FileSystem (Objeto)

SearchOption (Enumeración)

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetDirectories