Metodo My.Computer.FileSystem.GetDirectories

Aggiornamento: novembre 2007

Restituisce un insieme di stringhe che rappresenta i nomi dei percorsi delle sottodirectory contenute in una directory.

' 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)

Parametri

• directory
  String. Nome e percorso della directory. Obbligatorio.

• searchType
  Enumerazione SearchOption. Se includere o meno sottocartelle. Il valore predefinito è SearchOption.SearchTopLevelOnly. Obbligatorio.

• wildcards
  String. Criterio per la corrispondenza dei nomi. Obbligatorio.

Valore restituito

Insieme in sola lettura di String.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

• Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\) (ArgumentException).

• Il percorso non è valido in quanto Nothing (ArgumentNullException).

• Uno o più caratteri jolly specificati è Nothing, una stringa vuota o contiene soltanto spazi (ArgumentNullException).

• directory non esiste DirectoryNotFoundException).

• directory punta a un file esistente (IOException).

• La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).

• Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).

• L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).

• L'utente non dispone delle autorizzazioni necessarie (UnauthorizedAccessException).

Note

È possibile utilizzare il parametro wildcards per specificare un determinato criterio. Se si desidera includere il contenuto delle sottodirectory nella ricerca, impostare il parametro searchType su SearchAllSubDirectories.

Viene restituito un insieme vuoto se non vengono trovate directory corrispondenti al criterio specificato.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.GetDirectories.

Esempio

Nell'esempio seguente sono riportate tutte le directory incluse nella struttura di directory nel cui nome è contenuta la parola Logs che vengono quindi inserite in ListBox1.

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

In base all'esempio, nel form è necessario disporre di un oggetto ListBox denominato ListBox1.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

Autorizzazioni

Può essere necessaria l'autorizzazione seguente:

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Riferimenti

Oggetto My.Computer.FileSystem

Enumerazione SearchOption

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetDirectories