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.GetDirectories (String, String)

 

Data di pubblicazione: ottobre 2016

Restituisce i nomi delle sottodirectory (inclusi i percorsi) corrispondenti al criterio di ricerca specificato nella directory specificata.

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

public static string[] GetDirectories(
	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 sottodirectory in path. Questo parametro può contenere una combinazione di caratteri letterali e caratteri jolly (* e ?) validi (vedere la sezione Note), ma non supporta le espressioni regolari.

Valore restituito

Type: System.String[]

Una matrice dei nomi completi (inclusi i percorsi) delle sottodirectory che soddisfano i criteri di ricerca nella directory specificata o una matrice vuota se non viene trovata alcuna directory.

Exception Condition
UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

ArgumentException

path è una stringa di lunghezza zero, contiene solo spazi vuoti oppure contiene uno o più caratteri non validi. Per cercare i caratteri non validi, usare GetInvalidPathChars.

-oppure-

searchPattern non contiene un criterio valido.

ArgumentNullException

path o searchPattern è null.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle piattaforme basate su Windows i percorsi non devono superare 248 caratteri e i nomi file non possono essere composti da più di 260 caratteri.

IOException

path è un nome file.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

Questo metodo restituisce tutte le sottodirectory nella directory specificata corrispondenti al criterio di ricerca specificati. Se la directory specificata non dispone di alcuna sottodirectory o nessuna sottodirectory corrisponde il searchPattern parametro, questo metodo restituisce una matrice vuota. Viene cercata solo nella directory principale. Se si desidera cercare le sottodirectory, utilizzare il GetDirectories(String, String, SearchOption) metodo e specificare AllDirectories nel searchOption parametro.

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".

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.

Il path parametro può specificare un percorso relativo o assoluto e non è tra maiuscole e minuscole. Informazioni sul percorso relativo è interpretati rispetto alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

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

Per un elenco delle attività dei / o comuni, vedere Attività di I/O comuni.

Nell'esempio seguente conta il numero di directory in un percorso che iniziano con la lettera specificata.

using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        try 
        {
            // Only get subdirectories that begin with the letter "p."
            string[] dirs = Directory.GetDirectories(@"c:\", "p*");
            Console.WriteLine("The number of directories starting with p is {0}.", dirs.Length);
            foreach (string dir in dirs) 
            {
                Console.WriteLine(dir);
            }
        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

FileIOPermission

for access to path information for the current directory. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.PathDiscovery.

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 1.1
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Torna all'inizio
Mostra: