ZipFileExtensions.ExtractToDirectoryAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Estrae in modo asincrono tutti i file nell'archivio in una directory nel file system. La directory specificata può già esistere. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Estrae tutti i file nell'archivio in una directory nel file system. È possibile che la directory specificata esista già. |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Estrae in modo asincrono tutti i file nell'archivio in una directory nel file system. La directory specificata può già esistere.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- source
- ZipArchive
Archivio ZIP da cui estrarre i file.
- destinationDirectoryName
- String
Percorso della directory nel file system.
- cancellationToken
- CancellationToken
Token di annullamento da monitorare per le richieste di annullamento.
Valori restituiti
Eccezioni
destinationDirectoryName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
destinationDirectoryName è null.
Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi di file devono essere inferiori a 260 caratteri.
Il percorso specificato non è valido, ad esempio in un'unità non mappata.
Il nome di una voce di archivio è di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
oppure
L'estrazione di una voce di archivio avrebbe generato un file di destinazione esterno destinationDirectoryName , ad esempio se il nome della voce contiene funzioni di accesso alla directory padre.
oppure
Una voce di archivio ha lo stesso nome di una voce già estratta dallo stesso archivio.
Il chiamante non dispone dell'autorizzazione richiesta.
destinationDirectoryName è in un formato non valido.
Una voce di archivio non è stata trovata o è danneggiata.
oppure
Una voce di archivio è stata compressa usando un metodo di compressione non supportato.
Un'operazione asincrona viene annullata.
Commenti
La directory specificata non deve esistere. Il percorso è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.
Questo metodo crea tutte le sottodirectory e la directory specificata, se necessario.
Se si verifica un errore durante l'estrazione dell'archivio, l'archivio rimane parzialmente estratto.
Ogni voce viene estratta in modo che il file estratto abbia lo stesso percorso relativo della destinationDirectoryName voce alla radice dell'archivio. Se un file da archiviare ha un'ora dell'ultima modifica non valida, verrà utilizzato il primo valore datetime rappresentabile nel formato zip timestamp (mezzanotte il 1° gennaio 1980).
Si applica a
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Estrae tutti i file nell'archivio in una directory nel file system. È possibile che la directory specificata esista già.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- source
- ZipArchive
Archivio ZIP da cui estrarre i file.
- destinationDirectoryName
- String
Percorso della directory nel file system.
- overwriteFiles
- Boolean
true per sovrascrivere i file; false Altrimenti.
- cancellationToken
- CancellationToken
Token di annullamento da monitorare per le richieste di annullamento.
Valori restituiti
Eccezioni
destinationDirectoryName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
Questo metodo creerà tutte le sottodirectory e la directory specificata, se necessario.
Se si verifica un errore durante l'estrazione dell'archivio, l'archivio rimarrà parzialmente estratto.
Ogni voce viene estratta in modo che il file estratto abbia lo stesso percorso relativo della destinationDirectoryName voce alla radice dell'archivio. Se un file da archiviare ha un'ora dell'ultima modifica non valida, verrà utilizzato il primo valore datetime rappresentabile nel formato zip timestamp (mezzanotte il 1° gennaio 1980).
destinationDirectoryName è null.
Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.
Ad esempio, nelle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi di file devono essere inferiori a 260 caratteri.
Il percorso specificato non è valido, ad esempio in un'unità non mappata.
Il nome di una voce di archivio è di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
oppure
L'estrazione di una voce di archivio avrebbe generato un file di destinazione esterno destinationDirectoryName , ad esempio se il nome della voce contiene funzioni di accesso alla directory padre.
oppure
Una voce di archivio ha lo stesso nome di una voce già estratta dallo stesso archivio.
Il chiamante non dispone dell'autorizzazione richiesta.
destinationDirectoryName è in un formato non valido.
Una voce di archivio non è stata trovata o è danneggiata.
oppure
Una voce di archivio è stata compressa usando un metodo di compressione non supportato.
Commenti
La directory specificata non deve esistere. Il percorso è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.
