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 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
- Origine:
- Directory.cs
- 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
Raccolta enumerabile dei nomi di voci di file system nella directory specificata da path.
Eccezioni
.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().
path è null.
path non è valido, ad esempio fa riferimento a un'unità non mappata.
path è un nome file.
Il percorso specificato, il nome file o la combinazione di entrambi supera 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 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.
Si applica a
EnumerateFileSystemEntries(String, String)
- Origine:
- Directory.cs
- Origine:
- Directory.cs
- 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
Raccolta enumerabile di voci di file system nella directory specificata da path e corrispondenti al criterio di ricerca specificato.
Eccezioni
.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.
path non è valido, ad esempio fa riferimento a un'unità non mappata.
path è un nome file.
Il percorso specificato, il nome file o la combinazione di entrambi supera 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 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.
Si applica a
EnumerateFileSystemEntries(String, String, EnumerationOptions)
- Origine:
- Directory.cs
- Origine:
- Directory.cs
- 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
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
.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.
searchOption non è un valore valido di SearchOption.
path non è valido, ad esempio fa riferimento a un'unità non mappata.
path è un nome file.
Il percorso specificato, il nome file o la combinazione di entrambi supera 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 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.
Si applica a
EnumerateFileSystemEntries(String, String, SearchOption)
- Origine:
- Directory.cs
- Origine:
- Directory.cs
- 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
Raccolta enumerabile di voci di file system nella directory specificata da path e corrispondenti al criterio e all'opzione di ricerca specificata.
Eccezioni
.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.
searchOption non è un valore valido di SearchOption.
path non è valido, ad esempio fa riferimento a un'unità non mappata.
path è un nome file.
Il percorso specificato, il nome file o la combinazione di entrambi supera 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 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.
