Files.WalkFileTree Méthode

[Android.Runtime.Register("walkFileTree", "(Ljava/nio/file/Path;Ljava/nio/file/FileVisitor;)Ljava/nio/file/Path;", "", ApiSince=26)]
public static Java.Nio.FileNio.IPath? WalkFileTree(Java.Nio.FileNio.IPath? start, Java.Nio.FileNio.IFileVisitor? visitor);

[<Android.Runtime.Register("walkFileTree", "(Ljava/nio/file/Path;Ljava/nio/file/FileVisitor;)Ljava/nio/file/Path;", "", ApiSince=26)>]
static member WalkFileTree : Java.Nio.FileNio.IPath * Java.Nio.FileNio.IFileVisitor -> Java.Nio.FileNio.IPath

Paramètres

Retours

le fichier de démarrage

Attributs

RegisterAttribute

Remarques

Guide une arborescence de fichiers.

Cette méthode fonctionne comme si elle était équivalente à l’évaluation de l’expression : <blockquote>

walkFileTree(start, EnumSet.noneOf(FileVisitOption.class), Integer.MAX_VALUE, visitor)

</blockquote> En d’autres termes, il ne suit pas les liens symboliques et visite tous les niveaux de l’arborescence de fichiers.

Java documentation pour java.nio.file.Files.walkFileTree(java.nio.file.Path, java.nio.file.FileVisitor<? super java.nio.file.Path>).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("walkFileTree", "(Ljava/nio/file/Path;Ljava/util/Set;ILjava/nio/file/FileVisitor;)Ljava/nio/file/Path;", "", ApiSince=26)]
public static Java.Nio.FileNio.IPath? WalkFileTree(Java.Nio.FileNio.IPath? start, System.Collections.Generic.ICollection<Java.Nio.FileNio.FileVisitOption>? options, int maxDepth, Java.Nio.FileNio.IFileVisitor? visitor);

[<Android.Runtime.Register("walkFileTree", "(Ljava/nio/file/Path;Ljava/util/Set;ILjava/nio/file/FileVisitor;)Ljava/nio/file/Path;", "", ApiSince=26)>]
static member WalkFileTree : Java.Nio.FileNio.IPath * System.Collections.Generic.ICollection<Java.Nio.FileNio.FileVisitOption> * int * Java.Nio.FileNio.IFileVisitor -> Java.Nio.FileNio.IPath

Paramètres

Retours

le fichier de démarrage

Attributs

RegisterAttribute

Remarques

Guide une arborescence de fichiers.

Cette méthode décrit une arborescence de fichiers enracinée dans un fichier de démarrage donné. La traversée de l’arborescence de fichiers est <em>depth-first</em> avec l’appel donné FileVisitor pour chaque fichier rencontré. L’arborescence de fichiers se termine lorsque tous les fichiers accessibles de l’arborescence ont été visités ou qu’une méthode de visite renvoie un résultat .FileVisitResult#TERMINATE TERMINATE Lorsqu’une méthode de visite se termine en raison d’une IOExceptionerreur non interceptée ou d’une exception d’exécution, la traversée est arrêtée et l’erreur ou l’exception est propagée à l’appelant de cette méthode.

Pour chaque fichier rencontré, cette méthode tente de lire son java.nio.file.attribute.BasicFileAttributesfichier . Si le fichier n’est pas un répertoire, la FileVisitor#visitFile visitFile méthode est appelée avec les attributs de fichier. Si les attributs de fichier ne peuvent pas être lus, en raison d’une exception d’E/S, la FileVisitor#visitFileFailed visitFileFailed méthode est appelée avec l’exception d’E/S.

Où le fichier est un répertoire et que le répertoire n’a pas pu être ouvert, la visitFileFailed méthode est appelée avec l’exception d’E/S, après quoi, l’arborescence de fichiers continue, par défaut, au prochain <frère< em>/em> du répertoire.

Où le répertoire est ouvert avec succès, les entrées dans le répertoire et leurs <descendants< em>/em> sont visités. Lorsque toutes les entrées ont été visitées ou qu’une erreur d’E/S se produit pendant l’itération du répertoire, le répertoire est fermé et la méthode du FileVisitor#postVisitDirectory postVisitDirectory visiteur est appelée. L’arborescence de fichiers se poursuit ensuite, par défaut, au prochain <frère< em>/em> du répertoire.

Par défaut, les liens symboliques ne sont pas automatiquement suivis par cette méthode. Si le paramètre contient l’option optionsFileVisitOption#FOLLOW_LINKS FOLLOW_LINKS , les liens symboliques sont suivis. Lorsque vous suivez des liens et que les attributs de la cible ne peuvent pas être lus, cette méthode tente d’obtenir le BasicFileAttributes lien. S’ils peuvent être lus, la visitFile méthode est appelée avec les attributs du lien (sinon la visitFileFailed méthode est appelée comme spécifié ci-dessus).

Si le options paramètre contient l’option, cette méthode effectue le FileVisitOption#FOLLOW_LINKS FOLLOW_LINKS suivi des répertoires visités afin que les cycles puissent être détectés. Un cycle se produit lorsqu’il existe une entrée dans un répertoire qui est un ancêtre du répertoire. La détection du cycle est effectuée en enregistrant les java.nio.file.attribute.BasicFileAttributes#fileKey file-key répertoires, ou si les clés de fichier ne sont pas disponibles, en appelant la #isSameFile isSameFile méthode pour tester si un répertoire est le même fichier qu’un ancêtre. Lorsqu’un cycle est détecté, il est traité comme une erreur d’E/S et que la FileVisitor#visitFileFailed visitFileFailed méthode est appelée avec une instance de FileSystemLoopException.

Le maxDepth paramètre est le nombre maximal de niveaux de répertoires à visiter. Une valeur de 0 signifie que seul le fichier de démarrage est visité, sauf s’il est refusé par le gestionnaire de sécurité. Une valeur de Integer#MAX_VALUE MAX_VALUE peut être utilisée pour indiquer que tous les niveaux doivent être visités. La visitFile méthode est appelée pour tous les fichiers, y compris les répertoires, rencontrés à maxDepth, sauf si les attributs de fichier de base ne peuvent pas être lus, auquel cas la visitFileFailed méthode est appelée.

Si un visiteur retourne un résultat de l’opération null , NullPointerException il est levée.

Lorsqu’un gestionnaire de sécurité est installé et qu’il refuse l’accès à un fichier (ou répertoire), il est ignoré et le visiteur n’est pas appelé pour ce fichier (ou répertoire).

Java documentation pour java.nio.file.Files.walkFileTree(java.nio.file.Path, java.util.Set<java.nio.file.FileVisitOption>, int, java.nio.file.FileVisitor<? super java.nio.file.Path>).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.