Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Directory.EnumerateFileSystemEntries (String, String)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public static IEnumerable<string> EnumerateFileSystemEntries(
	string path,
	string searchPattern
)

Parametri

path
Type: System.String

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

searchPattern
Type: System.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 percorso letterale valido e caratteri jolly (* e ?) (vedere la sezione Note), ma non supporta espressioni regolari.

Valore restituito

Type: System.Collections.Generic.IEnumerable<String>

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

Exception Condition
ArgumentException

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per 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. Ad esempio, nelle piattaforme basate su Windows i percorsi devono contenere meno di 248 caratteri e i nomi file meno di 260 caratteri.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

searchPattern può essere una combinazione di valore letterale e caratteri jolly caratteri, ma non supporta le espressioni regolari. I seguenti caratteri jolly sono consentiti in searchPattern...

Identificatore con caratteri jolly

Corrispondenze

* (asterisco)

Zero o più caratteri in tale posizione.

? (punto interrogativo)

Zero o un carattere in tale posizione.

I caratteri diversi dal carattere jolly sono caratteri letterali. Ad esempio, il searchPattern stringa "* t" Cerca tutti i nomi in path che terminano con la lettera "t". Il searchPattern "s *" Cerca tutti i nomi di stringa path iniziano con la lettera "s".

System_CAPS_noteNota

Quando si utilizza il carattere jolly asterisco in un searchPattern ad esempio "*. txt", il numero di caratteri nell'estensione specificata influisce la ricerca come segue:

  • Se l'estensione specificata è esattamente tre caratteri, il metodo restituisce i file con estensioni che iniziano con l'estensione specificata. Ad esempio, "xls" restituisce "book.xls" sia "book.xlsx".

  • In tutti gli altri casi, il metodo restituisce i file che corrispondono esattamente l'estensione specificata. Ad esempio, "* interno" restituisce "file.ai" ma non "file.aif".

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

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

È possibile specificare informazioni di percorso con il path parametro. Informazioni sul percorso relativo è interpretati rispetto alla directory di lavoro corrente, è possibile determinare utilizzando il GetCurrentDirectory metodo.

Il EnumerateFileSystemEntries e GetFileSystemEntries metodi differiscono nel modo seguente: quando si utilizza EnumerateFileSystemEntries, è possibile avviare l'enumerazione dell'insieme di voci prima che venga restituito l'intero insieme, quando si utilizza GetFileSystemEntries, è necessario attendere che l'intera matrice di voci da restituire prima che sia possibile accedere alla matrice. Pertanto, quando si lavora con molti file e directory, EnumerateFiles può essere più efficiente.

La raccolta restituita non è memorizzato nella cache; ogni chiamata al GetEnumerator per la raccolta verrà avviata una nuova enumerazione.

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 4.0
Silverlight
Disponibile da 4.0
Torna all'inizio
Mostra: