Directory.EnumerateFileSystemEntries Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Retourne une collection énumérable d'entrées de système de fichiers qui répondent à des critères spécifiés.

Surcharges

EnumerateFileSystemEntries(String)	Retourne une collection énumérable de noms de fichiers et de noms de répertoires dans un chemin d’accès spécifié.
EnumerateFileSystemEntries(String, String)	Retourne une collection énumérable des noms de fichiers et des noms de répertoires qui correspondent à un modèle de recherche dans un chemin spécifié.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	Retourne une collection énumérable des noms de fichiers et des noms de répertoires qui correspondent à un modèle de recherche et à des options d’énumération dans un chemin spécifié.
EnumerateFileSystemEntries(String, String, SearchOption)	Retourne une collection énumérable des noms de fichiers et des noms de répertoires qui correspondent à un modèle de recherche dans un chemin d'accès spécifié, et effectue éventuellement des recherches dans les sous-répertoires.

EnumerateFileSystemEntries(String)

Source:

Directory.cs

Retourne une collection énumérable de noms de fichiers et de noms de répertoires dans un chemin d’accès spécifié.

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)

Paramètres

path

String

Le chemin d’accès relatif ou absolu du répertoire où effectuer la recherche. Cette chaîne n'est pas sensible à la casse.

Retours

IEnumerable<String>

Collection énumérable des entrées de système de fichiers dans le répertoire spécifié par path.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

path n’est pas valide, notamment s’il fait référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L'appelant n'a pas l'autorisation requise.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

Remarques

Vous pouvez spécifier des informations relatives sur le chemin d’accès avec le path paramètre . Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel, que vous pouvez déterminer à l’aide de la GetCurrentDirectory méthode .

Les EnumerateFileSystemEntries méthodes et GetFileSystemEntries diffèrent comme suit : Lorsque vous utilisez EnumerateFileSystemEntries, vous pouvez commencer à énumérer la collection d’entrées avant que la collection entière soit retournée ; lorsque vous utilisez GetFileSystemEntries, vous devez attendre que l’ensemble du tableau d’entrées soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFileSystemEntries peut être plus efficace.

La collection retournée n’est pas mise en cache ; chaque appel à sur GetEnumerator la collection démarre une nouvelle énumération.

EnumerateFileSystemEntries(String, String)

Source:

Directory.cs

Retourne une collection énumérable des noms de fichiers et des noms de répertoires qui correspondent à un modèle de recherche dans un chemin spécifié.

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)

Paramètres

path

String

Le chemin d’accès relatif ou absolu du répertoire où effectuer la recherche. Cette chaîne n'est pas sensible à la casse.

searchPattern

String

Chaîne recherchée à trouver parmi les noms des entrées du système de fichiers dans path. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques (* et ?), mais il ne prend pas en charge les expressions régulières.

Retours

IEnumerable<String>

Collection énumérable des entrées du système de fichiers dans le répertoire spécifié par path et qui correspondent au modèle de recherche spécifié.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

- ou -

searchPattern ne contient pas un modèle valide.

ArgumentNullException

path a la valeur null.

-ou-

searchPattern a la valeur null.

DirectoryNotFoundException

path n’est pas valide, notamment s’il fait référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L'appelant n'a pas l'autorisation requise.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

Remarques

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur générique	Correspond à
* (astérisque)	Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation)	Exactement un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littéraux. Par exemple, la searchPattern chaîne « *t » recherche tous les noms en path se terminant par la lettre « t ». La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Notes

Lorsque vous utilisez le caractère générique astérisque dans un searchPattern tel que « *.txt », le nombre de caractères dans l’extension spécifiée affecte la recherche comme suit :

• Si l’extension spécifiée contient exactement trois caractères, la méthode retourne des fichiers avec des extensions qui commencent par l’extension spécifiée. Par exemple, « *.xls » retourne « book.xls » et « book.xlsx ».
• Dans tous les autres cas, la méthode retourne des fichiers qui correspondent exactement à l’extension spécifiée. Par exemple, « *.ai » retourne « file.ai », mais pas « file.aif ».

Lorsque vous utilisez le caractère générique de point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifiée. Par exemple, pour deux fichiers, « file1.txt » et « file1.txtother », dans un répertoire, un modèle de recherche « file ?.txt » retourne uniquement le premier fichier, tandis qu’un modèle de recherche « file*.txt » renvoie les deux fichiers.

searchPattern ne peut pas se terminer par deux points (« .. ») ou contenir deux points (« .. ») suivis de DirectorySeparatorChar ou AltDirectorySeparatorChar, ni contenir des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars.

Vous pouvez spécifier des informations relatives sur le chemin d’accès avec le path paramètre . Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel, que vous pouvez déterminer à l’aide de la GetCurrentDirectory méthode .

Les EnumerateFileSystemEntries méthodes et GetFileSystemEntries diffèrent comme suit : Lorsque vous utilisez EnumerateFileSystemEntries, vous pouvez commencer à énumérer la collection d’entrées avant que la collection entière soit retournée ; lorsque vous utilisez GetFileSystemEntries, vous devez attendre que l’ensemble du tableau d’entrées soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFileSystemEntries peut être plus efficace.

La collection retournée n’est pas mise en cache ; chaque appel à sur GetEnumerator la collection démarre une nouvelle énumération.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Source:

Directory.cs

Retourne une collection énumérable des noms de fichiers et des noms de répertoires qui correspondent à un modèle de recherche et à des options d’énumération dans un chemin spécifié.

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)

Paramètres

path

String

Le chemin d’accès relatif ou absolu du répertoire où effectuer la recherche. Cette chaîne n'est pas sensible à la casse.

searchPattern

String

Chaîne recherchée à trouver parmi les noms de fichiers et de répertoires dans path. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques, mais il ne prend pas en charge les expressions régulières.

enumerationOptions

EnumerationOptions

Objet qui décrit la configuration de recherche et d’énumération à utiliser.

Retours

IEnumerable<String>

Collection énumérable des entrées de système de fichiers dans le répertoire spécifié par path et qui correspondent au modèle de recherche et aux options d’énumération spécifiés.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

- ou -

searchPattern ne contient pas un modèle valide.

ArgumentNullException

path a la valeur null.

-ou-

searchPattern a la valeur null.

ArgumentOutOfRangeException

searchOption n’est pas une valeur de SearchOption valide.

DirectoryNotFoundException

path n’est pas valide, notamment s’il fait référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L'appelant n'a pas l'autorisation requise.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

Remarques

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur générique	Correspond à
* (astérisque)	Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation)	Exactement un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littéraux. Par exemple, la searchPattern chaîne « *t » recherche tous les noms en path se terminant par la lettre « t ». La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Notes

Lorsque vous utilisez le caractère générique d’astérisque dans un searchPattern tel que « *.txt », le nombre de caractères dans l’extension spécifiée affecte la recherche comme suit :

• Si l’extension spécifiée contient exactement trois caractères, la méthode retourne les fichiers dont les extensions commencent par l’extension spécifiée. Par exemple, « *.xls » retourne « book.xls » et « book.xlsx ».
• Dans tous les autres cas, la méthode retourne des fichiers qui correspondent exactement à l’extension spécifiée. Par exemple, « *.ai » retourne « file.ai » mais pas « file.aif ».

Lorsque vous utilisez le caractère générique de point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifiée. Par exemple, avec deux fichiers, « file1.txt » et « file1.txtother », dans un répertoire, un modèle de recherche « file ?.txt » retourne uniquement le premier fichier, tandis qu’un modèle de recherche « file*.txt » retourne les deux fichiers.

searchPattern ne peut pas se terminer par deux points (« .. ») ou contenir deux points (« .. ») suivis de DirectorySeparatorChar ou AltDirectorySeparatorChar, et il ne peut pas non plus contenir des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars.

Vous pouvez spécifier des informations relatives sur le chemin d’accès avec le path paramètre . Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel, que vous pouvez déterminer à l’aide de la GetCurrentDirectory méthode .

Les EnumerateFileSystemEntries méthodes et GetFileSystemEntries diffèrent comme suit : lorsque vous utilisez EnumerateFileSystemEntries, vous pouvez commencer à énumérer la collection d’entrées avant que l’ensemble de la collection soit retourné ; lorsque vous utilisez GetFileSystemEntries, vous devez attendre que l’ensemble du tableau d’entrées soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFileSystemEntries peut être plus efficace.

La collection retournée n’est pas mise en cache ; chaque appel à sur GetEnumerator la collection démarre une nouvelle énumération.

EnumerateFileSystemEntries(String, String, SearchOption)

Source:

Directory.cs

Retourne une collection énumérable des noms de fichiers et des noms de répertoires qui correspondent à un modèle de recherche dans un chemin d'accès spécifié, et effectue éventuellement des recherches dans les sous-répertoires.

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)

Paramètres

path

String

Le chemin d’accès relatif ou absolu du répertoire où effectuer la recherche. Cette chaîne n'est pas sensible à la casse.

searchPattern

String

Chaîne recherchée à trouver parmi les entrées de système de fichiers dans path. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques (* et ?), mais il ne prend pas en charge les expressions régulières.

searchOption

SearchOption

Une des valeurs d'énumération qui spécifie si l'opération de recherche doit inclure seulement le répertoire actuel ou si elle doit inclure tous les sous-répertoires. La valeur par défaut est TopDirectoryOnly.

Retours

IEnumerable<String>

Collection énumérable des entrées de système de fichiers dans le répertoire spécifié par path et qui correspondent au modèle et à l’option de recherche spécifiés.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

- ou -

searchPattern ne contient pas un modèle valide.

ArgumentNullException

path a la valeur null.

-ou-

searchPattern a la valeur null.

ArgumentOutOfRangeException

searchOption n’est pas une valeur de SearchOption valide.

DirectoryNotFoundException

path n’est pas valide, notamment s’il fait référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L'appelant n'a pas l'autorisation requise.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

Remarques

searchPattern peut être une combinaison de caractères littéral et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur générique	Correspond à
* (astérisque)	Zéro ou plus caractères dans cette position.
? (point d’interrogation)	Exactement un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littérals. Par exemple, la searchPattern chaîne « *t » recherche tous les noms se path terminant par la lettre « t ». La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Notes

Lorsque vous utilisez le caractère générique d’astérisque dans un searchPattern tel que « *.txt », le nombre de caractères dans l’extension spécifiée affecte la recherche comme suit :

• Si l’extension spécifiée contient exactement trois caractères, la méthode retourne les fichiers dont les extensions commencent par l’extension spécifiée. Par exemple, « *.xls » retourne « book.xls » et « book.xlsx ».
• Dans tous les autres cas, la méthode retourne des fichiers qui correspondent exactement à l’extension spécifiée. Par exemple, « *.ai » retourne « file.ai » mais pas « file.aif ».

Lorsque vous utilisez le caractère générique de point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifiée. Par exemple, avec deux fichiers, « file1.txt » et « file1.txtother », dans un répertoire, un modèle de recherche « file ?.txt » retourne uniquement le premier fichier, tandis qu’un modèle de recherche « file*.txt » retourne les deux fichiers.

searchPattern ne peut pas se terminer par deux points (« .. ») ou contenir deux points (« .. ») suivis de DirectorySeparatorChar ou AltDirectorySeparatorChar, et il ne peut pas non plus contenir des caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars.

Vous pouvez spécifier des informations relatives sur le chemin d’accès avec le path paramètre . Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel, que vous pouvez déterminer à l’aide de la GetCurrentDirectory méthode .

Les EnumerateFileSystemEntries méthodes et GetFileSystemEntries diffèrent comme suit : lorsque vous utilisez EnumerateFileSystemEntries, vous pouvez commencer à énumérer la collection d’entrées avant que l’ensemble de la collection soit retourné ; lorsque vous utilisez GetFileSystemEntries, vous devez attendre que l’ensemble du tableau d’entrées soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFileSystemEntries peut être plus efficace.

La collection retournée n’est pas mise en cache ; chaque appel à sur GetEnumerator la collection démarre une nouvelle énumération.