Directory.EnumerateFileSystemEntries Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce una raccolta enumerabile di voci del file system che soddisfano i criteri specificati.
Overload
| Nome | Descrizione |
|---|---|
| EnumerateFileSystemEntries(String) |
Restituisce una raccolta enumerabile di nomi di file e nomi di directory in un percorso specificato. |
| EnumerateFileSystemEntries(String, String) |
Restituisce una raccolta enumerabile di nomi di file e nomi 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 nomi 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 nomi di directory che corrispondono a un criterio di ricerca in un percorso specificato e, facoltativamente, cerca nelle sottodirectory. |
EnumerateFileSystemEntries(String)
Restituisce una raccolta enumerabile di nomi di file e nomi 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. Questa stringa non fa distinzione tra maiuscole e minuscole.
Valori restituiti
Raccolta enumerabile di voci del file system nella directory specificata da path.
Eccezioni
.NET Framework e .NET versioni core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
path è null.
path non è valido, ad esempio il riferimento a un'unità non mappata.
path è un nome di file.
Il percorso, il nome file o la combinazione specificati superano la lunghezza massima definita dal sistema.
Il chiamante non dispone dell'autorizzazione richiesta.
Il chiamante non dispone dell'autorizzazione richiesta.
Commenti
È possibile specificare informazioni relative sul percorso con il path parametro . Le informazioni sul percorso relative 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 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.
Si applica a
EnumerateFileSystemEntries(String, String)
Restituisce una raccolta enumerabile di nomi di file e nomi 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. Questa stringa non fa distinzione tra maiuscole e minuscole.
- searchPattern
- String
Stringa di ricerca che deve corrispondere ai nomi delle voci del file system in path. Questo parametro può contenere una combinazione di caratteri jolly e percorso letterale validi (* e ?), ma non supporta espressioni regolari.
Valori restituiti
Raccolta enumerabile di voci del file system nella directory specificata da path e che corrispondono al criterio di ricerca specificato.
Eccezioni
.NET Framework e .NET versioni core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
oppure
searchPattern non contiene un modello valido.
path non è valido, ad esempio il riferimento a un'unità non mappata.
path è un nome di file.
Il percorso, il nome file o la combinazione specificati superano la lunghezza massima definita dal sistema.
Il chiamante non dispone dell'autorizzazione richiesta.
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 jolly seguenti sono consentiti in searchPattern.
| Identificatore di caratteri jolly | Matches |
|---|---|
| * (asterisco) | Zero o più caratteri in tale posizione. |
| ? (punto interrogativo) | Esattamente un carattere in quella 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 che path iniziano con la lettera "s".
Annotazioni
Quando si usa il carattere jolly asterisco in un searchPattern oggetto 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 i 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars.
È possibile specificare informazioni relative sul percorso con il path parametro . Le informazioni sul percorso relative 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 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.
Si applica a
EnumerateFileSystemEntries(String, String, EnumerationOptions)
Restituisce una raccolta enumerabile di nomi di file e nomi 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. Questa stringa non fa distinzione tra maiuscole e minuscole.
- searchPattern
- String
Stringa di ricerca che deve corrispondere ai nomi di file e directory in path. Questo parametro può contenere una combinazione di caratteri letterali e caratteri jolly validi, ma non supporta espressioni regolari.
- enumerationOptions
- EnumerationOptions
Oggetto che descrive la configurazione di ricerca ed enumerazione da utilizzare.
Valori restituiti
Raccolta enumerabile di voci del file system nella directory specificata da path, che corrispondono al criterio di ricerca specificato e alle opzioni di enumerazione specificate.
Eccezioni
.NET Framework e .NET versioni core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
oppure
searchPattern non contiene un modello valido.
path non è valido, ad esempio il riferimento a un'unità non mappata.
path è un nome di file.
Il percorso, il nome file o la combinazione specificati superano la lunghezza massima definita dal sistema.
Il chiamante non dispone dell'autorizzazione richiesta.
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 jolly seguenti sono consentiti in searchPattern.
| Identificatore di caratteri jolly | Matches |
|---|---|
| * (asterisco) | Zero o più caratteri in tale posizione. |
| ? (punto interrogativo) | Esattamente un carattere in quella 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 che path iniziano con la lettera "s".
Annotazioni
Quando si usa il carattere jolly asterisco in un searchPattern oggetto 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 i 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars.
È possibile specificare informazioni relative sul percorso con il path parametro . Le informazioni sul percorso relative 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 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.
Si applica a
EnumerateFileSystemEntries(String, String, SearchOption)
Restituisce una raccolta enumerabile di nomi di file e nomi di directory che corrispondono a un criterio di ricerca in un percorso specificato e, facoltativamente, cerca 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. Questa stringa non fa distinzione tra maiuscole e minuscole.
- searchPattern
- String
Stringa di ricerca che deve corrispondere alle voci del file system in path. Questo parametro può contenere una combinazione di caratteri jolly e percorso letterale validi (* e ?), ma non supporta espressioni regolari.
- searchOption
- SearchOption
Uno dei valori di enumerazione che specifica se l'operazione di ricerca deve includere solo la directory corrente o deve includere tutte le sottodirectory. Il valore predefinito è TopDirectoryOnly.
Valori restituiti
Raccolta enumerabile di voci del file system nella directory specificata da path e che corrispondono al criterio di ricerca e all'opzione specificati.
Eccezioni
.NET Framework e .NET versioni core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().
oppure
searchPattern non contiene un modello valido.
searchOption non è un valore valido SearchOption .
path non è valido, ad esempio il riferimento a un'unità non mappata.
path è un nome di file.
Il percorso, il nome file o la combinazione specificati superano la lunghezza massima definita dal sistema.
Il chiamante non dispone dell'autorizzazione richiesta.
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 jolly seguenti sono consentiti in searchPattern.
| Identificatore di caratteri jolly | Matches |
|---|---|
| * (asterisco) | Zero o più caratteri in tale posizione. |
| ? (punto interrogativo) | Esattamente un carattere in quella 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 che path iniziano con la lettera "s".
Annotazioni
Quando si usa il carattere jolly asterisco in un searchPattern oggetto 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 i 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars.
È possibile specificare informazioni relative sul percorso con il path parametro . Le informazioni sul percorso relative 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 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.