Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Directory.GetFiles méthode (String, String, SearchOption)

 

Date de publication : novembre 2016

Retourne les noms des fichiers (y compris leurs chemins d'accès) qui correspondent au modèle de recherche spécifié dans le répertoire spécifié, en utilisant une valeur pour déterminer s'il faut effectuer une recherche dans les sous-répertoires.

Espace de noms:   System.IO
Assembly:  mscorlib (dans mscorlib.dll)

public static string[] GetFiles(
	string path,
	string searchPattern,
	SearchOption searchOption
)

Paramètres

path
Type: System.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
Type: System.String

Chaîne recherchée à trouver parmi les noms de fichiers dans path. Ce paramètre peut contenir une combinaison de chemins d’accès littéraux valides et de caractères génériques (* et ?) (voir la section Notes), mais ne prend pas en charge les expressions régulières.

searchOption
Type: System.IO.SearchOption

L’une des valeurs d’énumération qui spécifie si l’opération de recherche doit inclure tous les sous-répertoires ou seulement le répertoire actuel.

Valeur de retour

Type: System.String[]

Tableau des noms complets (y compris les chemins d'accès) pour les fichiers du répertoire spécifié qui correspondent au modèle et à l'option de recherche spécifiés, ou tableau vide si aucun fichier n'est trouvé.

Exception Condition
ArgumentException

path est une chaîne de longueur nulle, contient seulement un espace, ou un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides avec la méthode GetInvalidPathChars.

ou

searchPattern ne contient pas un modèle valide.

ArgumentNullException

path ou searchpattern a la valeur null.

ArgumentOutOfRangeException

searchOption n’est pas une valeur SearchOption valide.

UnauthorizedAccessException

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

DirectoryNotFoundException

Le chemin spécifié est introuvable ou n’est pas valide (par exemple, il est sur un lecteur non mappé).

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins ne doivent pas dépasser 248 caractères et les noms de fichiers ne doivent pas dépasser 260 caractères.

IOException

path est un nom de fichier.

ou

Une erreur réseau s’est produite.

Les noms de fichier retournés sont ajoutés au paramètre fourni path et l’ordre des noms de fichiers retournés n’est pas garanti ; utilisez la Sort méthode si un ordre de tri spécifique est requis.

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

Spécificateur de caractère générique

Correspondance

* (astérisque)

Zéro ou plusieurs caractères à cette position.

? (point d’interrogation)

Zéro ou un caractère à cette position.

Caractères autres que les caractères génériques sont des caractères littéraux. Par exemple, le searchPattern chaîne « * t » recherche tous les noms dans path se terminant par la lettre « t ». Le searchPattern « s * » recherche tous les noms de chaîne path commençant par la lettre « s ».

searchPattern ne peut pas se terminer par deux points («.. ») ni contenir deux points («.. ») suivi 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.

System_CAPS_noteRemarque

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

  • Si l’extension spécifiée est exactement trois caractères, la méthode retourne les fichiers portant les extensions qui commencent avec l’extension spécifiée. Par exemple, « *.xls » retourne « book.xls » et « book.xlsx ».

  • Dans tous les autres cas, la méthode retourne les 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 point d’interrogation, cette méthode retourne uniquement les fichiers qui correspondent à l’extension de fichier spécifié. Par exemple, avec deux fichiers, « file1.txt » et « fichier1.txtautre » situés dans un répertoire, un modèle de recherche « fichier ?. txt » retourne simplement le premier fichier, tandis qu’un modèle de recherche de « file*.txt » retourne les deux fichiers.

System_CAPS_noteRemarque

Étant donné que cette méthode vérifie par rapport aux noms de fichier avec le format de nom de 8.3 fichier et le format de nom de fichier long, un modèle de recherche semblable à « * 1*.txt » peut retourner des noms de fichier inattendue. Par exemple, à l’aide d’un modèle de recherche de « * 1*.txt » retourne « longfilename.txt » car le format de nom de 8.3 fichier équivalent est « LongFi ~ 1.txt ».

Le EnumerateFiles et GetFiles méthodes diffèrent comme suit : lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection de noms avant que la collection entière est retournée ; lorsque vous utilisez GetFiles, vous devez attendre la totalité du tableau de noms à retourner avant que vous pouvez accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles peut être plus efficace.

Les noms de fichiers incluent le chemin d’accès complet.

Le path paramètre permet de spécifier les informations de chemin d’accès relatif ou absolu. Les informations de chemin d’accès relatif sont interprétées comme étant relatif au répertoire de travail actuel. Pour obtenir le répertoire de travail actif, consultez GetCurrentDirectory.

Le path paramètre n’est pas sensible à la casse.

Pour obtenir la liste des tâches d’e/s courantes, consultez Tâches d'E/S courantes.

FileIOPermission

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

Plateforme Windows universelle
Disponible depuis 10
.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: