Directory.EnumerateFileSystemEntries Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Restituisce una raccolta enumerabile di voci di file system che soddisfano i criteri specificati.

Overload

EnumerateFileSystemEntries(String)	Restituisce una raccolta enumerabile di nomi di file e di directory in un percorso specificato.
EnumerateFileSystemEntries(String, String)	Restituisce una raccolta enumerabile di nomi di file e di directory che corrispondono a un criterio di ricerca in un percorso specificato.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	Restituisce una raccolta enumerabile di nomi di file e di directory che corrispondono a un criterio di ricerca e alle opzioni di enumerazione in un percorso specificato.
EnumerateFileSystemEntries(String, String, SearchOption)	Restituisce una raccolta enumerabile di nomi di file e di directory che corrispondono a un criterio di ricerca in un percorso specificato e con ricerca facoltativa nelle sottodirectory.

EnumerateFileSystemEntries(String)

Origine:

Directory.cs

Restituisce una raccolta enumerabile di nomi di file e di directory in un percorso specificato.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path);

static member EnumerateFileSystemEntries : string -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)

Parametri

path

String

Percorso relativo o assoluto della directory in cui eseguire la ricerca. Stringa senza distinzione tra maiuscole e minuscole.

Restituisce

IEnumerable<String>

Raccolta enumerabile dei nomi di voci di file system nella directory specificata da path.

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

ArgumentNullException

path è null.

DirectoryNotFoundException

path non è valido, ad esempio fa riferimento a un'unità non mappata.

IOException

path è un nome file.

PathTooLongException

Il percorso specificato, il nome file o la combinazione di entrambi supera la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

È possibile specificare informazioni relative sul percorso con il path parametro . Le informazioni relative sul percorso vengono interpretate come relative alla directory di lavoro corrente, che è possibile determinare usando il GetCurrentDirectory metodo .

I EnumerateFileSystemEntries metodi e GetFileSystemEntries differiscono nel modo seguente: quando si utilizza , è possibile iniziare a enumerare la raccolta di voci prima che venga restituita l'intera raccolta. Quando si utilizza EnumerateFileSystemEntriesGetFileSystemEntries, è necessario attendere che venga restituita l'intera matrice di voci prima di poter accedere alla matrice. Pertanto, quando si lavora con molti file e directory, EnumerateFileSystemEntries può essere più efficiente.

La raccolta restituita non viene memorizzata nella cache; ogni chiamata a nella GetEnumerator raccolta avvierà una nuova enumerazione.

EnumerateFileSystemEntries(String, String)

Origine:

Directory.cs

Restituisce una raccolta enumerabile di nomi di file e di directory che corrispondono a un criterio di ricerca in un percorso specificato.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path, string searchPattern);

static member EnumerateFileSystemEntries : string * string -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)

Parametri

path

String

Percorso relativo o assoluto della directory in cui eseguire la ricerca. Stringa senza distinzione tra maiuscole e minuscole.

searchPattern

String

Stringa di ricerca in base alla quale confrontare i nomi delle voci di file system in path. Questo parametro può contenere una combinazione di caratteri del percorso letterale e caratteri jolly (* e ?) validi, ma non supporta le espressioni regolari.

Restituisce

IEnumerable<String>

Raccolta enumerabile di voci di file system nella directory specificata da path e corrispondenti al criterio di ricerca specificato.

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

-oppure-

searchPattern non contiene un modello valido.

ArgumentNullException

path è null.

-oppure-

searchPattern è null.

DirectoryNotFoundException

path non è valido, ad esempio fa riferimento a un'unità non mappata.

IOException

path è un nome file.

PathTooLongException

Il percorso specificato, il nome file o la combinazione di entrambi supera la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

searchPattern può essere una combinazione di caratteri letterali e caratteri jolly, ma non supporta espressioni regolari. Gli identificatori con caratteri jolly seguenti sono consentiti in searchPattern.

Identificatore di caratteri jolly	Corrispondenze
* (asterisco)	Zero o più caratteri in tale posizione.
? (punto interrogativo)	Esattamente un carattere in quella posizione.

I caratteri diversi dai caratteri jolly sono caratteri letterali. Ad esempio, la searchPattern stringa "*t" cerca tutti i nomi che path terminano con la lettera "t". La searchPattern stringa "s*" cerca tutti i nomi che iniziano path con la lettera "s".

Nota

Quando si utilizza il carattere jolly asterisco in un searchPattern tipo come "*.txt", il numero di caratteri nell'estensione specificata influisce sulla ricerca come indicato di seguito:

• Se l'estensione specificata è lunga esattamente tre caratteri, il metodo restituisce file con estensioni che iniziano con l'estensione specificata. Ad esempio, "*.xls" restituisce sia "book.xls" che "book.xlsx".
• In tutti gli altri casi, il metodo restituisce file che corrispondono esattamente all'estensione specificata. Ad esempio, "*.ai" restituisce "file.ai", ma non "file.aif".

Quando si utilizza il carattere jolly del punto interrogativo, questo metodo restituisce solo i file che corrispondono all'estensione di file specificata. Ad esempio, dato due file, "file1.txt" e "file1.txtother", in una directory, un modello di ricerca di "file?.txt" restituisce solo il primo file, mentre un modello di ricerca "file*.txt" restituisce entrambi i file.

searchPattern non può terminare in due punti ("..") o contenere due punti ("..") seguiti da DirectorySeparatorChar o AltDirectorySeparatorChar, né può contenere caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars.

È possibile specificare informazioni relative sul percorso con il path parametro . Le informazioni relative sul percorso vengono interpretate come relative alla directory di lavoro corrente, che è possibile determinare usando il GetCurrentDirectory metodo .

I EnumerateFileSystemEntries metodi e GetFileSystemEntries differiscono nel modo seguente: quando si utilizza , è possibile iniziare a enumerare la raccolta di voci prima che venga restituita l'intera raccolta. Quando si utilizza EnumerateFileSystemEntriesGetFileSystemEntries, è necessario attendere che venga restituita l'intera matrice di voci prima di poter accedere alla matrice. Pertanto, quando si lavora con molti file e directory, EnumerateFileSystemEntries può essere più efficiente.

La raccolta restituita non viene memorizzata nella cache; ogni chiamata a nella GetEnumerator raccolta avvierà una nuova enumerazione.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Origine:

Directory.cs

Restituisce una raccolta enumerabile di nomi di file e di directory che corrispondono a un criterio di ricerca e alle opzioni di enumerazione in un percorso specificato.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);

static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)

Parametri

path

String

Percorso relativo o assoluto della directory in cui eseguire la ricerca. Stringa senza distinzione tra maiuscole e minuscole.

searchPattern

String

Stringa di ricerca in base alla quale confrontare i nomi dei file e delle directory in path. Questo parametro può contenere una combinazione di caratteri letterali e caratteri jolly validi, ma non supporta le espressioni regolari.

enumerationOptions

EnumerationOptions

Oggetto che descrive la configurazione di ricerca ed enumerazione da usare.

Restituisce

IEnumerable<String>

Raccolta enumerabile di voci di file system nella directory specificata da path e corrispondenti al criterio di ricerca e alle opzioni di enumerazione specificati.

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

-oppure-

searchPattern non contiene un modello valido.

ArgumentNullException

path è null.

-oppure-

searchPattern è null.

ArgumentOutOfRangeException

searchOption non è un valore valido di SearchOption.

DirectoryNotFoundException

path non è valido, ad esempio fa riferimento a un'unità non mappata.

IOException

path è un nome file.

PathTooLongException

Il percorso specificato, il nome file o la combinazione di entrambi supera la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

searchPattern può essere una combinazione di caratteri letterali e caratteri jolly, ma non supporta espressioni regolari. Gli identificatori con caratteri jolly seguenti sono consentiti in searchPattern.

Identificatore di caratteri jolly	Corrispondenze
* (asterisco)	Zero o più caratteri in tale posizione.
? (punto interrogativo)	Esattamente un carattere in quella posizione.

I caratteri diversi dai caratteri jolly sono caratteri letterali. Ad esempio, la searchPattern stringa "*t" cerca tutti i nomi che path terminano con la lettera "t". La searchPattern stringa "s*" cerca tutti i nomi in path inizio con la lettera "s".

Nota

Quando si usa il carattere jolly asterisco in un searchPattern esempio "*.txt", il numero di caratteri nell'estensione specificata influisce sulla ricerca come indicato di seguito:

• Se l'estensione specificata è esattamente tre caratteri, il metodo restituisce file con estensioni che iniziano con l'estensione specificata. Ad esempio, "*.xls" restituisce sia "book.xls" sia "book.xlsx".
• In tutti gli altri casi, il metodo restituisce i file che corrispondono esattamente all'estensione specificata. Ad esempio, "*.ai" restituisce "file.ai" ma non "file.aif".

Quando si usa il carattere jolly punto interrogativo, questo metodo restituisce solo i file corrispondenti all'estensione di file specificata. Ad esempio, in due file, "file1.txt" e "file1.txtother", in una directory, un modello di ricerca "file?.txt" restituisce solo il primo file, mentre un modello di ricerca "file*.txt" restituisce entrambi i file.

searchPattern non può terminare in due periodi ("..") o contenere due periodi ("..") seguiti da DirectorySeparatorChar o AltDirectorySeparatorChar, né può contenere caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars.

È possibile specificare le informazioni relative sul percorso con il path parametro . Le informazioni relative sul percorso vengono interpretate come relative alla directory di lavoro corrente, che è possibile determinare usando il GetCurrentDirectory metodo .

I EnumerateFileSystemEntries metodi e GetFileSystemEntries differiscono come segue: quando si usa EnumerateFileSystemEntries, è possibile iniziare a enumerare la raccolta di voci prima che venga restituita l'intera raccolta. Quando si usa GetFileSystemEntries, è necessario attendere che l'intera matrice di voci venga restituita prima di poter accedere alla matrice. Pertanto, quando si utilizzano molti file e directory, EnumerateFileSystemEntries può essere più efficiente.

La raccolta restituita non viene memorizzata nella cache; ogni chiamata all'oggetto nella GetEnumerator raccolta avvierà una nuova enumerazione.

EnumerateFileSystemEntries(String, String, SearchOption)

Origine:

Directory.cs

Restituisce una raccolta enumerabile di nomi di file e di directory che corrispondono a un criterio di ricerca in un percorso specificato e con ricerca facoltativa nelle sottodirectory.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path, string searchPattern, System.IO.SearchOption searchOption);

static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)

Parametri

path

String

Percorso relativo o assoluto della directory in cui eseguire la ricerca. Stringa senza distinzione tra maiuscole e minuscole.

searchPattern

String

Stringa di ricerca in base alla quale confrontare le voci di file system in path. Questo parametro può contenere una combinazione di caratteri del percorso letterale e caratteri jolly (* e ?) validi, ma non supporta le espressioni regolari.

searchOption

SearchOption

Uno dei valori di enumerazione che specifica se l'operazione di ricerca deve includere solo la directory corrente o tutte le sottodirectory. Il valore predefinito è TopDirectoryOnly.

Restituisce

IEnumerable<String>

Raccolta enumerabile di voci di file system nella directory specificata da path e corrispondenti al criterio e all'opzione di ricerca specificata.

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti a 2.1: path è una stringa a lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

-oppure-

searchPattern non contiene un modello valido.

ArgumentNullException

path è null.

-oppure-

searchPattern è null.

ArgumentOutOfRangeException

searchOption non è un valore valido di SearchOption.

DirectoryNotFoundException

path non è valido, ad esempio fa riferimento a un'unità non mappata.

IOException

path è un nome file.

PathTooLongException

Il percorso specificato, il nome file o la combinazione di entrambi supera la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

searchPattern può essere una combinazione di caratteri letterali e jolly, ma non supporta espressioni regolari. Gli identificatori jolly seguenti sono consentiti in searchPattern.

Identificatore jolly	Corrispondenze
* (asterisco)	Zero o più caratteri in tale posizione.
? (punto interrogativo)	Esattamente un carattere in tale posizione.

I caratteri diversi dal carattere jolly sono caratteri letterali. Ad esempio, la searchPattern stringa "*t" cerca tutti i nomi path che terminano con la lettera "t". La searchPattern stringa "s*" cerca tutti i nomi in path inizio con la lettera "s".

Nota

Quando si usa il carattere jolly asterisco in un searchPattern esempio "*.txt", il numero di caratteri nell'estensione specificata influisce sulla ricerca come indicato di seguito:

• Se l'estensione specificata è esattamente tre caratteri, il metodo restituisce file con estensioni che iniziano con l'estensione specificata. Ad esempio, "*.xls" restituisce sia "book.xls" sia "book.xlsx".
• In tutti gli altri casi, il metodo restituisce i file che corrispondono esattamente all'estensione specificata. Ad esempio, "*.ai" restituisce "file.ai" ma non "file.aif".

Quando si usa il carattere jolly punto interrogativo, questo metodo restituisce solo i file corrispondenti all'estensione di file specificata. Ad esempio, in due file, "file1.txt" e "file1.txtother", in una directory, un modello di ricerca "file?.txt" restituisce solo il primo file, mentre un modello di ricerca "file*.txt" restituisce entrambi i file.

searchPattern non può terminare in due periodi ("..") o contenere due periodi ("..") seguiti da DirectorySeparatorChar o AltDirectorySeparatorChar, né può contenere caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars.

È possibile specificare le informazioni relative sul percorso con il path parametro . Le informazioni relative sul percorso vengono interpretate come relative alla directory di lavoro corrente, che è possibile determinare usando il GetCurrentDirectory metodo .

I EnumerateFileSystemEntries metodi e GetFileSystemEntries differiscono come segue: quando si usa EnumerateFileSystemEntries, è possibile iniziare a enumerare la raccolta di voci prima che venga restituita l'intera raccolta. Quando si usa GetFileSystemEntries, è necessario attendere che l'intera matrice di voci venga restituita prima di poter accedere alla matrice. Pertanto, quando si utilizzano molti file e directory, EnumerateFileSystemEntries può essere più efficiente.

La raccolta restituita non viene memorizzata nella cache; ogni chiamata all'oggetto nella GetEnumerator raccolta avvierà una nuova enumerazione.