Files.WalkFileTree Metodo

[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

Parametri

Valori restituiti

il file iniziale

Attributi

RegisterAttribute

Commenti

Illustra un albero dei file.

Questo metodo funziona come se richiamasse l'espressione equivalente alla valutazione dell'espressione: <blockquote>

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

</blockquote> In altre parole, non segue i collegamenti simbolici e visita tutti i livelli dell'albero dei file.

per java.nio.file.Files.walkFileTree(java.nio.file.Path, java.nio.file.FileVisitor<? super java.nio.file.Path>).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 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

Parametri

Valori restituiti

il file iniziale

Attributi

RegisterAttribute

Commenti

Illustra un albero dei file.

Questo metodo illustra un albero di file rooted in un determinato file iniziale. L'attraversamento dell'albero dei file è <em>depth-first</em> con l'oggetto FileVisitor richiamato per ogni file rilevato. L'attraversamento dell'albero dei file viene completato quando tutti i file accessibili nell'albero sono stati visitati oppure un metodo visit restituisce un risultato di FileVisitResult#TERMINATE TERMINATE. Quando un metodo visit termina a causa di un IOException, un errore non rilevato o un'eccezione di runtime, l'attraversamento viene terminato e l'errore o l'eccezione viene propagata al chiamante di questo metodo.

Per ogni file rilevato questo metodo tenta di leggere il relativo java.nio.file.attribute.BasicFileAttributes. Se il file non è una directory, il FileVisitor#visitFile visitFile metodo viene richiamato con gli attributi del file. Se non è possibile leggere gli attributi del file, a causa di un'eccezione di I/O, il FileVisitor#visitFileFailed visitFileFailed metodo viene richiamato con l'eccezione di I/O.

Dove il file è una directory e non è stato possibile aprire la directory, il visitFileFailed metodo viene richiamato con l'eccezione di I/O, dopo di che, la procedura dettagliata dell'albero dei file continua, per impostazione predefinita, al successivo <em>di pari< livello/em> della directory.

Quando la directory viene aperta correttamente, vengono visitate le voci nella directory e i relativi <>discendenti</em>. Quando tutte le voci sono state visitate o si verifica un errore di I/O durante l'iterazione della directory, la directory viene chiusa e viene richiamato il metodo del FileVisitor#postVisitDirectory postVisitDirectory visitatore. La procedura dettagliata dell'albero dei file continua, per impostazione predefinita, al successivo <em di pari< livello/em> della>directory.

Per impostazione predefinita, i collegamenti simbolici non vengono seguiti automaticamente da questo metodo. Se il options parametro contiene l'opzione FileVisitOption#FOLLOW_LINKS FOLLOW_LINKS , vengono seguiti i collegamenti simbolici. Quando i collegamenti seguenti e gli attributi della destinazione non possono essere letti, questo metodo tenta di ottenere il BasicFileAttributes del collegamento. Se possono essere lette, il visitFile metodo viene richiamato con gli attributi del collegamento . In caso contrario, il visitFileFailed metodo viene richiamato come specificato in precedenza.

Se il options parametro contiene l'opzione FileVisitOption#FOLLOW_LINKS FOLLOW_LINKS , questo metodo tiene traccia delle directory visitate in modo che i cicli possano essere rilevati. Un ciclo si verifica quando è presente una voce in una directory che è un predecessore della directory. Il rilevamento del ciclo viene eseguito registrando le java.nio.file.attribute.BasicFileAttributes#fileKey file-key directory o se le chiavi del file non sono disponibili, richiamando il #isSameFile isSameFile metodo per verificare se una directory è lo stesso file di un predecessore. Quando viene rilevato un ciclo, viene considerato come un errore di I/O e il FileVisitor#visitFileFailed visitFileFailed metodo viene richiamato con un'istanza di FileSystemLoopException.

Il maxDepth parametro è il numero massimo di livelli di directory da visitare. Un valore indica 0 che viene visitato solo il file iniziale, a meno che non venga negato dal gestore della sicurezza. È possibile utilizzare un valore di Integer#MAX_VALUE MAX_VALUE per indicare che tutti i livelli devono essere visitati. Il visitFile metodo viene richiamato per tutti i file, incluse le directory, rilevate in maxDepth, a meno che non sia possibile leggere gli attributi di file di base, nel qual caso viene richiamato il visitFileFailed metodo .

Se un visitatore restituisce un risultato, nullNullPointerException viene generato .

Quando un gestore della sicurezza viene installato e nega l'accesso a un file (o a una directory), viene ignorato e il visitatore non viene richiamato per tale file (o directory).

per 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>).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.