Metodo My.Computer.FileSystem.GetFiles

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un insieme di stringhe in sola lettura che rappresenta i nomi dei file contenuti in una directory.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parametri

directory
String. Directory in cui eseguire la ricerca. Obbligatorio.
searchType
Enumerazione SearchOption. Indica se includere o meno le sottocartelle. Il valore predefinito è SearchOption.SearchTopLevelOnly. Obbligatorio.
wildcards
String. Schema da cercare. Obbligatorio.

Valore restituito

Insieme di stringhe in sola lettura.

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).
directory non esiste(DirectoryNotFoundException).
directory fa riferimento 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

Viene restituito un insieme vuoto se non vengono trovati file corrispondenti al modello specificato.

Attività

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

Per	Vedere
Ottenere l'insieme dei file di una directory	Procedura: ottenere l'insieme di file di una directory in Visual Basic
Trovare file con motivo specifico all'interno di una directory	Procedura: cercare file con un criterio di ricerca specifico in Visual Basic

Esempio

Nell'esempio seguente tutti i file della directory vengono restituiti e aggiunti a ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

Nell'esempio è necessario disporre di un oggetto ListBox denominato ListBox1 nel form.

Nell'esempio vengono restituiti tutti i file della directory con estensione .dll che vengono aggiunti 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

Nell'esempio è necessario disporre di un oggetto ListBox denominato ListBox1 nel form.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce l'accesso a FileSystem)

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

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	Sì
Servizio Windows	Sì
Sito Web	Sì