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.
Estrae tutti i file nell'archivio in una directory nel file system. È possibile che la directory specificata esista già.
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. La directory specificata può già esistere. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
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. La directory può già esistere. Le directory mancanti vengono create in base alle esigenze durante l'estrazione delle voci.
- 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
Warning
Questo metodo non deve essere utilizzato per estrarre archivi non attendibili. Non applica limiti di dimensioni, limiti del numero di voci o altri criteri necessari per l'estrazione sicura di archivi non attendibili. Per altre informazioni sull'estrazione sicura degli archivi da origini non attendibili, vedere Procedure consigliate per l'uso di archivi zip e tar.
La directory specificata da destinationDirectoryName può esistere già. Questo metodo crea la directory di destinazione, le directory padre mancanti e le sottodirectory in base alle esigenze durante l'estrazione delle voci. Se l'archivio è vuoto, questo metodo non crea la directory di destinazione.
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.
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. La directory specificata può già esistere.
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. La directory può già esistere. Le directory mancanti vengono create in base alle esigenze durante l'estrazione delle voci.
- 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 crea directory mancanti in base alle esigenze durante l'estrazione di voci.
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
Warning
Questo metodo non deve essere utilizzato per estrarre archivi non attendibili. Non applica limiti di dimensioni, limiti del numero di voci o altri criteri necessari per l'estrazione sicura di archivi non attendibili. Per altre informazioni sull'estrazione sicura degli archivi da origini non attendibili, vedere Procedure consigliate per l'uso di archivi zip e tar.
La directory specificata da destinationDirectoryName può esistere già. Questo metodo crea la directory di destinazione, le directory padre mancanti e le sottodirectory in base alle esigenze durante l'estrazione delle voci. Se l'archivio è vuoto, questo metodo non crea la directory di destinazione.
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.
Si applica a
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- source
- ZipArchive
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti. La directory può già esistere. Le directory mancanti vengono create in base alle esigenze durante l'estrazione delle voci.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Valori restituiti
Commenti
Warning
Questo metodo non deve essere utilizzato per estrarre archivi non attendibili. Non applica limiti di dimensioni, limiti del numero di voci o altri criteri necessari per l'estrazione sicura di archivi non attendibili. Per altre informazioni sull'estrazione sicura degli archivi da origini non attendibili, vedere Procedure consigliate per l'uso di archivi zip e tar.
La directory specificata da destinationDirectoryName può esistere già. Questo metodo crea la directory di destinazione, le directory padre mancanti e le sottodirectory in base alle esigenze durante l'estrazione delle voci. Se l'archivio è vuoto, questo metodo non crea la directory di destinazione.
Ogni file estratto ha lo stesso percorso relativo della destinationDirectoryName voce di origine alla radice dell'archivio.
Il destinationDirectoryName parametro accetta percorsi relativi e assoluti. Un percorso relativo viene interpretato come relativo alla directory di lavoro corrente.
Se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto.
Impostare OverwriteFiles su true per sovrascrivere i file esistenti. Il valore predefinito è false, che fa sì che l'estrazione generi un'eccezione IOException se esiste già un file.
Usare Password per specificare la password per le voci crittografate.
EntryNameEncoding non viene usato da questo overload. I nomi e i commenti delle voci vengono decodificati usando la codifica specificata all'apertura dell'archivio source .
I collegamenti simbolici nell'archivio non vengono ricreati come collegamenti simbolici. Se destinationDirectoryName o una delle directory padre è una giunzione preesistente o un collegamento simbolico, il collegamento viene seguito e l'estrazione scrive nella cartella di destinazione finale.
Le eccezioni che si verificano durante l'estrazione asincrona vengono archiviate nell'attività restituita e vengono generate quando l'attività è attesa.
