FileSystemProxy.GetFiles Metodo

Definizione

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

Overload

GetFiles(String, SearchOption, String[])

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

GetFiles(String)

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

GetFiles(String, SearchOption, String[])

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

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)

Parametri

directory
String

Directory in cui eseguire la ricerca.

searchType
SearchOption

Specifica se includere le sottocartelle. Il valore predefinito è SearchOption.SearchTopLevelOnly.

wildcards
String[]

Criterio da soddisfare.

Restituisce

Insieme di sola lettura dei nomi di file della directory specificata.

Eccezioni

Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\).

directory è Nothing.

La directory da cercare non esiste.

directory fa riferimento a un file esistente.

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

L'utente non dispone delle autorizzazioni necessarie.

Esempio

L'esempio seguente restituisce tutti i file della directory e li aggiunge a ListBox1.

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

In questo esempio è necessario disporre di un ListBox nome ListBox1 nel modulo.

Questo esempio restituisce tutti i file nella directory con l'estensione .txt e li aggiunge 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

In questo esempio è necessario disporre di un ListBox nome ListBox1 nel modulo.

Commenti

Se non vengono trovati file corrispondenti al criterio specificato, verrà restituita una raccolta vuota.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.GetFiles metodo.

A Vedere
Ottenere la raccolta di file in una directory Procedura: Ottenere la raccolta di file di una directory
Trovare i file con un modello specifico in una directory Procedura: Trovare file con un criterio specifico

Vedi anche

Si applica a

GetFiles(String)

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

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)

Parametri

directory
String

Directory in cui eseguire la ricerca.

Restituisce

Insieme di sola lettura dei nomi di file della directory specificata.

Eccezioni

Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\).

directory è Nothing.

La directory da cercare non esiste.

directory fa riferimento a un file esistente.

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

L'utente non dispone delle autorizzazioni necessarie.

Esempio

L'esempio seguente restituisce tutti i file della directory e li aggiunge a ListBox1.

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

In questo esempio è necessario disporre di un ListBox nome ListBox1 nel modulo.

Questo esempio restituisce tutti i file nella directory con l'estensione .txt e li aggiunge 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

In questo esempio è necessario disporre di un ListBox nome ListBox1 nel modulo.

Commenti

Se non vengono trovati file corrispondenti al criterio specificato, verrà restituita una raccolta vuota.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.GetFiles metodo.

A Vedere
Ottenere la raccolta di file in una directory Procedura: Ottenere la raccolta di file di una directory
Trovare i file con un modello specifico in una directory Procedura: Trovare file con un criterio specifico

Vedi anche

Si applica a