Files.WalkFileTree Método

[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

Parámetros

Devoluciones

el archivo de inicio

Atributos

RegisterAttribute

Comentarios

Recorre un árbol de archivos.

Este método funciona como si la invocación fuera equivalente a evaluar la expresión: <blockquote>

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

</blockquote> En otras palabras, no sigue vínculos simbólicos y visita todos los niveles del árbol de archivos.

Java documentación para java.nio.file.Files.walkFileTree(java.nio.file.Path, java.nio.file.FileVisitor<? super java.nio.file.Path>).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative 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

Parámetros

Devoluciones

el archivo de inicio

Atributos

RegisterAttribute

Comentarios

Recorre un árbol de archivos.

Este método recorre un árbol de archivos con raíz en un archivo inicial determinado. El recorrido del árbol de archivos es <em>depth-first</em> con el especificado FileVisitor invocado para cada archivo encontrado. El recorrido del árbol de archivos se completa cuando se han visitado todos los archivos accesibles del árbol o un método visit devuelve un resultado de FileVisitResult#TERMINATE TERMINATE. Cuando un método visit finaliza debido a un IOExceptionerror no detectado o una excepción en tiempo de ejecución, el recorrido finaliza y el error o excepción se propaga al autor de la llamada de este método.

Para cada archivo encontrado este método intenta leer su java.nio.file.attribute.BasicFileAttributes. Si el archivo no es un directorio, se invoca el FileVisitor#visitFile visitFile método con los atributos de archivo. Si no se pueden leer los atributos de archivo, debido a una excepción de E/S, se invoca el FileVisitor#visitFileFailed visitFileFailed método con la excepción de E/S.

Donde el archivo es un directorio y el directorio no se pudo abrir, se invoca el visitFileFailed método con la excepción de E/S, después de lo cual el recorrido del árbol de archivos continúa, de forma predeterminada, en el siguiente><< elemento relacionado/em> del directorio.

Donde el directorio se abre correctamente, se visitan las entradas del directorio y sus <>descendientes</em>. Cuando se han visitado todas las entradas o se produce un error de E/S durante la iteración del directorio, se cierra el directorio y se invoca el método del FileVisitor#postVisitDirectory postVisitDirectory visitante. A continuación, el recorrido del árbol de archivos continúa, de forma predeterminada, en el siguiente <>elemento< relacionado/em> del directorio.

De forma predeterminada, los vínculos simbólicos no van seguidos automáticamente de este método. Si el options parámetro contiene la FileVisitOption#FOLLOW_LINKS FOLLOW_LINKS opción , se siguen los vínculos simbólicos. Cuando se muestran los vínculos siguientes y no se pueden leer los atributos del destino, este método intenta obtener el BasicFileAttributes del vínculo. Si se pueden leer, el visitFile método se invoca con los atributos del vínculo (de lo contrario, el visitFileFailed método se invoca como se especificó anteriormente).

Si el options parámetro contiene la FileVisitOption#FOLLOW_LINKS FOLLOW_LINKS opción , este método realiza un seguimiento de los directorios visitados para que se puedan detectar ciclos. Un ciclo surge cuando hay una entrada en un directorio que es un antecesor del directorio. La detección del ciclo se realiza mediante la grabación de los java.nio.file.attribute.BasicFileAttributes#fileKey file-key directorios, o si las claves de archivo no están disponibles, invocando el #isSameFile isSameFile método para probar si un directorio es el mismo archivo que un antecesor. Cuando se detecta un ciclo, se trata como un error de E/S y el FileVisitor#visitFileFailed visitFileFailed método se invoca con una instancia de FileSystemLoopException.

El maxDepth parámetro es el número máximo de niveles de directorios que se van a visitar. Un valor de 0 significa que solo se visita el archivo inicial, a menos que el administrador de seguridad lo deniegue. Se puede usar un valor de Integer#MAX_VALUE MAX_VALUE para indicar que se deben visitar todos los niveles. El visitFile método se invoca para todos los archivos, incluidos los directorios, encontrados en maxDepth, a menos que no se puedan leer los atributos de archivo básicos, en cuyo caso se invoca el visitFileFailed método .

Si un visitante devuelve un resultado de null , NullPointerException se produce .

Cuando se instala un administrador de seguridad y deniega el acceso a un archivo (o directorio), se omite y el visitante no se invoca para ese archivo (o directorio).

Java documentación para 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>).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.