Directory.EnumerateFileSystemEntries Méthode

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
netstandard.dll

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

Surcharges

Nom Description
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 de noms de fichiers et de noms de répertoires qui correspondent à un modèle de recherche dans un chemin d’accès spécifié.
EnumerateFileSystemEntries(String, String, EnumerationOptions)

Retourne une collection énumérable de noms de fichiers et de noms de répertoire qui correspondent à un modèle de recherche et des options d’énumération dans un chemin d’accès spécifié.
EnumerateFileSystemEntries(String, String, SearchOption)

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

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

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

Chemin d’accès relatif ou absolu au répertoire à rechercher. Cette chaîne n’est pas sensible à la casse.

Retours

IEnumerable<String>

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

Exceptions

ArgumentException

.NET Framework et les versions .NET Core 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 des caractères non valides à l’aide de la méthode GetInvalidPathChars().

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

path n’est pas valide, par exemple en faisant référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès, le nom de fichier ou combiné spécifié 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 les méthodes 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 vous pouvez être plus efficace.

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

S’applique à

EnumerateFileSystemEntries(String, String)

Retourne une collection énumérable de noms de fichiers et de noms de répertoires qui correspondent à un modèle de recherche dans un chemin d’accès 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

Chemin d’accès relatif ou absolu au répertoire à rechercher. Cette chaîne n’est pas sensible à la casse.

searchPattern
String

Chaîne de recherche à mettre en correspondance avec les noms des entrées du système de fichiers dans path. Ce paramètre peut contenir une combinaison de caractères génériques et de chemins littéraux valides (* et ?), mais il ne prend pas en charge les expressions régulières.

Retours

IEnumerable<String>

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

Exceptions

ArgumentException

.NET Framework et les versions .NET Core 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 des caractères non valides à l’aide de la méthode GetInvalidPathChars().

-ou-

searchPattern ne contient pas de modèle valide.

ArgumentNullException

path a la valeur null.

-ou-

searchPattern a la valeur null.

DirectoryNotFoundException

path n’est pas valide, par exemple en faisant référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès, le nom de fichier ou combiné spécifié 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 de caractères génériques Correspondances
* (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é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 ».

Note

Lorsque vous utilisez le caractère générique astérisque dans un searchPattern caractère générique 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 est 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 à la fois «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 du point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifiée. Par exemple, étant donné deux fichiers, «file1.txt» et « file1.txtother », dans un répertoire, un modèle de recherche de « fichier ?.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 périodes (« .. ») ou contenir deux points (« .. ») suivis DirectorySeparatorChar ou AltDirectorySeparatorChar, ni ne peuvent contenir de caractères non valides. Vous pouvez rechercher des 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 les méthodes 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 vous pouvez être plus efficace.

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

S’applique à

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Retourne une collection énumérable de noms de fichiers et de noms de répertoire qui correspondent à un modèle de recherche et des options d’énumération dans un chemin d’accès 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

Chemin d’accès relatif ou absolu au répertoire à rechercher. Cette chaîne n’est pas sensible à la casse.

searchPattern
String

Chaîne de recherche à mettre en correspondance avec les noms des fichiers et répertoires dans path. Ce paramètre peut contenir une combinaison de caractères littéraux et génériques valides, 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 d’entrées de système de fichiers dans le répertoire spécifié par path, qui correspondent au modèle de recherche spécifié et aux options d’énumération spécifiées.

Exceptions

ArgumentException

.NET Framework et les versions .NET Core 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 des caractères non valides à l’aide de la méthode GetInvalidPathChars().

-ou-

searchPattern ne contient pas de modèle valide.

ArgumentNullException

path a la valeur null.

-ou-

searchPattern a la valeur null.

DirectoryNotFoundException

path n’est pas valide, par exemple en faisant référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès, le nom de fichier ou combiné spécifié 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 de caractères génériques Correspondances
* (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é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 ».

Note

Lorsque vous utilisez le caractère générique astérisque dans un searchPattern caractère générique 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 est 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 à la fois «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 du point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifiée. Par exemple, étant donné deux fichiers, «file1.txt» et « file1.txtother », dans un répertoire, un modèle de recherche de « fichier ?.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 périodes (« .. ») ou contenir deux points (« .. ») suivis DirectorySeparatorChar ou AltDirectorySeparatorChar, ni ne peuvent contenir de caractères non valides. Vous pouvez rechercher des 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 les méthodes 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 vous pouvez être plus efficace.

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

S’applique à

EnumerateFileSystemEntries(String, String, SearchOption)

Retourne une collection énumérable de noms de fichiers et de noms de répertoires qui correspondent à un modèle de recherche dans un chemin d’accès spécifié et recherche éventuellement des 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

Chemin d’accès relatif ou absolu au répertoire à rechercher. Cette chaîne n’est pas sensible à la casse.

searchPattern
String

Chaîne de recherche à mettre en correspondance avec les entrées du système de fichiers dans path. Ce paramètre peut contenir une combinaison de caractères génériques et de chemins littéraux valides (* 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 uniquement le répertoire actif ou doit inclure tous les sous-répertoires. La valeur par défaut est TopDirectoryOnly.

Retours

IEnumerable<String>

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

Exceptions

ArgumentException

.NET Framework et les versions .NET Core 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 des caractères non valides à l’aide de la méthode GetInvalidPathChars().

-ou-

searchPattern ne contient pas de modèle valide.

ArgumentNullException

path a la valeur null.

-ou-

searchPattern a la valeur null.

ArgumentOutOfRangeException

searchOption n’est pas une valeur valide SearchOption .

DirectoryNotFoundException

path n’est pas valide, par exemple en faisant référence à un lecteur non mappé.

IOException

path est un nom de fichier.

PathTooLongException

Le chemin d’accès, le nom de fichier ou combiné spécifié 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 de caractères génériques Correspondances
* (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é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 ».

Note

Lorsque vous utilisez le caractère générique astérisque dans un searchPattern caractère générique 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 est 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 à la fois «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 du point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifiée. Par exemple, étant donné deux fichiers, «file1.txt» et « file1.txtother », dans un répertoire, un modèle de recherche de « fichier ?.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 périodes (« .. ») ou contenir deux points (« .. ») suivis DirectorySeparatorChar ou AltDirectorySeparatorChar, ni ne peuvent contenir de caractères non valides. Vous pouvez rechercher des 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 les méthodes 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 vous pouvez être plus efficace.

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

S’applique à