ZipFile.ExtractToDirectory 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 ZIP specificato in una directory del file system.
Overload
| ExtractToDirectory(String, String, Encoding, Boolean) |
Estrae tutti i file nell'archivio specificato in una directory del file system. |
| ExtractToDirectory(Stream, String, Encoding, Boolean) |
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system, usa la codifica di caratteri specificata per i nomi di voce e facoltativamente consente di scegliere se i file nella directory di destinazione devono essere sovrascritti. |
| ExtractToDirectory(String, String, Encoding) |
Estrae tutti i file nell'archivio ZIP specificato in una directory del file system e usa la codifica caratteri specificata per i nomi di voci. |
| ExtractToDirectory(String, String, Boolean) |
Estrae tutti i file nell'archivio specificato in una directory del file system. |
| ExtractToDirectory(Stream, String, Boolean) |
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system e, facoltativamente, consente di scegliere se i file nella directory di destinazione devono essere sovrascritti. |
| ExtractToDirectory(String, String) |
Estrae tutti i file nell'archivio ZIP specificato in una directory del file system. |
| ExtractToDirectory(Stream, String) |
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system. |
| ExtractToDirectory(Stream, String, Encoding) |
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system e usa la codifica dei caratteri specificata per i nomi di voce. |
ExtractToDirectory(String, String, Encoding, Boolean)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file nell'archivio specificato in una directory del file system.
public:
static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding, bool overwriteFiles);public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles);public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding, bool overwriteFiles);static member ExtractToDirectory : string * string * System.Text.Encoding * bool -> unitPublic Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean)Parametri
- sourceArchiveFileName
- String
Percorso nel file system dell'archivio da estrarre.
- destinationDirectoryName
- String
Percorso della directory di destinazione nel file system.
- entryNameEncoding
- Encoding
Codifica da usare durante la lettura dei nomi delle voci in questo ZipArchive.
- overwriteFiles
- Boolean
true per sovrascrivere i file. false in caso contrario,.
Eccezioni
sourceArchiveFileName o destinationDirectoryName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.
-oppure-
entryNameEncoding è impostato su una codifica Unicode diversa da UTF-8.
sourceArchiveFileName o destinationDirectoryName è null.
sourceArchiveFileName o destinationDirectoryName specifica un percorso, un nome di file o entrambi che superano la lunghezza massima definita dal sistema.
Il percorso specificato da sourceArchiveFileName o destinationDirectoryName non è valido (ad esempio si trova in un'unità non mappata).
overwriteFiles è false e una voce di archivio da estrarre ha lo stesso nome di un file già esistente in destinationDirectoryName.
-oppure-
Si è verificato un errore di I/O.
-oppure-
Il nome di un ZipArchiveEntry è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.
-oppure-
Con l'estrazione di ZipArchiveEntry si otterrebbe una destinazione di file all'esterno della directory di destinazione, ad esempio a causa delle funzioni di accesso della directory padre.
-oppure-
Un ZipArchiveEntry ha lo stesso nome di una voce già estratta dallo stesso archivio.
Il chiamante non dispone dell'autorizzazione richiesta.
Il formato di sourceArchiveFileName o destinationDirectoryName non è valido.
Il parametro sourceArchiveFileName non è stato trovato.
L'archivio specificato da sourceArchiveFileName non è un ZipArchive valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
La voce è stata compressa con un metodo di compressione non supportato.
Commenti
Se si verifica un errore durante l'estrazione dell'archivio, l'archivio rimarrà parzialmente estratto.
Ogni voce verrà estratta in modo che il file estratto abbia lo stesso percorso relativo a quello destinationDirectoryName della voce che deve essere archiviato.
I sourceArchiveFileName parametri e destinationDirectoryName accettano percorsi relativi e assoluti. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
Se un file da archiviare ha un'ora di ultima modifica non valida, verrà utilizzata la prima data e l'ora rappresentabili nel formato timestamp Zip (mezzanotte il 1° gennaio 1980).
Si applica a
ExtractToDirectory(Stream, String, Encoding, Boolean)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system, usa la codifica di caratteri specificata per i nomi di voce e facoltativamente consente di scegliere se i file nella directory di destinazione devono essere sovrascritti.
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding, bool overwriteFiles);public static void ExtractToDirectory (System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles);static member ExtractToDirectory : System.IO.Stream * string * System.Text.Encoding * bool -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean)Parametri
- source
- Stream
Flusso da cui estrarre l'archivio zip.
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti, specificato come percorso relativo o assoluto. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
- entryNameEncoding
- Encoding
La codifica da utilizzare durante la lettura o la scrittura dei nomi delle voci in questo archivio. Specificare un valore per il parametro solo quando una codifica è obbligatoria per l'interoperabilità con gli strumenti e le librerie dell'archivio ZIP che non supportano la codifica UTF-8 per i nomi di voce.
- overwriteFiles
- Boolean
true per sovrascrivere i file. false in caso contrario,.
Eccezioni
destinationDirectoryName> è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
entryNameEncoding è impostato su una codifica Unicode diversa da UTF-8.
destinationDirectoryName o source è null.
Il percorso specificato in destinationDirectoryName supera la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il nome di una voce nell'archivio è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
L'estrazione di una voce dell'archivio crea un file esterno alla directory specificata da destinationDirectoryName. (Ad esempio, si potrebbe verificare se il nome dell'elemento contiene accessori della directory padre).
-oppure-
overwriteFiles è false e una voce di archivio da estrarre ha lo stesso nome di una voce già estratta o che esiste in destinationDirectoryName.
Il chiamante non dispone dell'autorizzazione necessaria per accedere all'archivio o alla directory di destinazione.
destinationDirectoryName o contiene un formato non valido.
L'archivio contenuto nel source flusso non è un archivio zip valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
Una voce dell'archivio è stata compressa con un metodo di compressione non supportato.
Commenti
Questo metodo crea la directory specificata e tutte le sottodirectory. La directory di destinazione non può già esistere. Le eccezioni correlate alla convalida dei percorsi nell'archivio destinationDirectoryName zip contenuti nell'archivio source zip vengono generate prima dell'estrazione. In caso contrario, se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto. Ogni file estratto ha lo stesso percorso relativo della directory specificata dalla destinationDirectoryName relativa voce di origine deve corrispondere alla radice dell'archivio. Se un file da archiviare ha un'ora di ultima modifica non valida, verrà utilizzata la prima data e l'ora rappresentabili nel formato timestamp Zip (mezzanotte il 1° gennaio 1980).
Si applica a
ExtractToDirectory(String, String, Encoding)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file nell'archivio ZIP specificato in una directory del file system e usa la codifica caratteri specificata per i nomi di voci.
public:
static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding);public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding);public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding);static member ExtractToDirectory : string * string * System.Text.Encoding -> unitPublic Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding)Parametri
- sourceArchiveFileName
- String
Percorso dell'archivio da estrarre.
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti, specificato come percorso relativo o assoluto. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
- entryNameEncoding
- Encoding
La codifica da utilizzare durante la lettura o la scrittura dei nomi delle voci in questo archivio. Specificare un valore per il parametro solo quando una codifica è obbligatoria per l'interoperabilità con gli strumenti e le librerie dell'archivio ZIP che non supportano la codifica UTF-8 per i nomi di voce.
Eccezioni
destinationDirectoryName o sourceArchiveFileName è Empty, contiene solo spazi vuoti oppure almeno un carattere non valido.
-oppure-
entryNameEncoding è impostato su una codifica Unicode diversa da UTF-8.
destinationDirectoryName o sourceArchiveFileName è null.
La lunghezza del percorso specificata in destinationDirectoryName o sourceArchiveFileName supera la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il nome di una voce nell'archivio è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
L'estrazione di una voce dell'archivio crea un file esterno alla directory specificata da destinationDirectoryName. (Ad esempio, si potrebbe verificare se il nome dell'elemento contiene accessori della directory padre).
-oppure-
Una voce di archivio da estrarre ha lo stesso nome di una voce già estratta o presente in destinationDirectoryName.
Il chiamante non dispone dell'autorizzazione necessaria per accedere all'archivio o alla directory di destinazione.
destinationDirectoryName o sourceArchiveFileName contiene un formato non valido.
Il parametro sourceArchiveFileName non è stato trovato.
L'archivio specificato nel parametro sourceArchiveFileName non è un archivio ZIP valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
Una voce dell'archivio è stata compressa con un metodo di compressione non supportato.
Commenti
Questo metodo crea la directory specificata e tutte le sottodirectory, se necessario. Le eccezioni correlate alla convalida dei percorsi nei parametri o sourceArchiveFileName vengono generate prima dell'estrazionedestinationDirectoryName. In caso contrario, se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto. Ogni file estratto ha lo stesso percorso relativo della directory specificata dalla destinationDirectoryName relativa voce di origine deve corrispondere alla radice dell'archivio.
Se entryNameEncoding è impostato su un valore diverso da null, i nomi di voce vengono decodificati in base alle regole seguenti:
- Per i nomi di voce in cui il flag di codifica della lingua (nel flag a bit generico dell'intestazione del file locale) non è impostato, i nomi di voce vengono decodificati usando la codifica specificata.
- Per le voci in cui è impostato il flag di codifica della lingua, i nomi di voce vengono decodificati usando UTF-8.
Se entryNameEncoding è impostato su null, i nomi di voce vengono decodificati in base alle regole seguenti:
- Per le voci in cui il flag di codifica della lingua (nel flag a bit generico dell'intestazione del file locale) non è impostato, i nomi di voce vengono decodificati usando la tabella codici predefinita del sistema corrente.
- Per le voci in cui è impostato il flag di codifica della lingua, i nomi di voce vengono decodificati usando UTF-8.
Si applica a
ExtractToDirectory(String, String, Boolean)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file nell'archivio specificato in una directory del file system.
public:
static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles);static member ExtractToDirectory : string * string * bool -> unitPublic Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)Parametri
- sourceArchiveFileName
- String
Percorso nel file system dell'archivio da estrarre.
- destinationDirectoryName
- String
Percorso della directory di destinazione nel file system.
- overwriteFiles
- Boolean
true per sovrascrivere i file. false in caso contrario,.
Eccezioni
sourceArchiveFileName o destinationDirectoryName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.
sourceArchiveFileName o destinationDirectoryName è null.
sourceArchiveFileName o destinationDirectoryName specifica un percorso, un nome di file o entrambi che superano la lunghezza massima definita dal sistema.
Il percorso specificato da sourceArchiveFileName o destinationDirectoryName non è valido (ad esempio si trova in un'unità non mappata).
overwriteFiles è false e destinationDirectoryName contiene già un file con lo stesso nome di un file estratto.
-oppure-
Si è verificato un errore di I/O.
-oppure-
Il nome di un ZipArchiveEntry è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.
-oppure-
Con l'estrazione di ZipArchiveEntry si otterrebbe una destinazione di file all'esterno della directory di destinazione, ad esempio a causa delle funzioni di accesso della directory padre.
-oppure-
Un ZipArchiveEntry ha lo stesso nome di una voce dello stesso archivio già estratto.
Il chiamante non dispone dell'autorizzazione richiesta.
Il formato di sourceArchiveFileName o destinationDirectoryName non è valido.
Il parametro sourceArchiveFileName non è stato trovato.
L'archivio specificato da sourceArchiveFileName non è un ZipArchive valido.
-oppure-
Impossibile trovare un ZipArchiveEntry o la voce trovata è danneggiata.
-oppure-
Un ZipArchiveEntry è stato compresso con un metodo di compressione non supportato.
Commenti
Se si verifica un errore durante l'estrazione dell'archivio, l'archivio rimarrà parzialmente estratto.
Ogni voce verrà estratta in modo che il file estratto abbia lo stesso percorso relativo a quello destinationDirectoryName della voce che deve essere archiviato.
I sourceArchiveFileName parametri e destinationDirectoryName accettano percorsi relativi e assoluti. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
Se un file da archiviare ha un'ora di ultima modifica non valida, verrà utilizzata la prima data e l'ora rappresentabili nel formato timestamp Zip (mezzanotte il 1° gennaio 1980).
Si applica a
ExtractToDirectory(Stream, String, Boolean)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system e, facoltativamente, consente di scegliere se i file nella directory di destinazione devono essere sovrascritti.
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);public static void ExtractToDirectory (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles);static member ExtractToDirectory : System.IO.Stream * string * bool -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)Parametri
- source
- Stream
Flusso da cui estrarre l'archivio zip.
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti, specificato come percorso relativo o assoluto. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
- overwriteFiles
- Boolean
true per sovrascrivere i file. false in caso contrario,.
Eccezioni
destinationDirectoryName> è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
destinationDirectoryName o source è null.
Il percorso specificato in destinationDirectoryName supera la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il nome di una voce nell'archivio è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
L'estrazione di una voce dell'archivio crea un file esterno alla directory specificata da destinationDirectoryName. (Ad esempio, si potrebbe verificare se il nome dell'elemento contiene accessori della directory padre).
-oppure-
overwriteFiles è false e una voce di archivio da estrarre ha lo stesso nome di una voce già estratta o che esiste in destinationDirectoryName.
Il chiamante non dispone dell'autorizzazione necessaria per accedere all'archivio o alla directory di destinazione.
destinationDirectoryName o contiene un formato non valido.
L'archivio contenuto nel source flusso non è un archivio zip valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
Una voce dell'archivio è stata compressa con un metodo di compressione non supportato.
Commenti
Questo metodo crea la directory specificata e tutte le sottodirectory. La directory di destinazione non può già esistere. Le eccezioni correlate alla convalida dei percorsi nell'archivio destinationDirectoryName zip contenuti nell'archivio source zip vengono generate prima dell'estrazione. In caso contrario, se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto. Ogni file estratto ha lo stesso percorso relativo della directory specificata dalla destinationDirectoryName relativa voce di origine deve corrispondere alla radice dell'archivio. Se un file da archiviare ha un'ora di ultima modifica non valida, verrà utilizzata la prima data e l'ora rappresentabili nel formato timestamp Zip (mezzanotte il 1° gennaio 1980).
Si applica a
ExtractToDirectory(String, String)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file nell'archivio ZIP specificato in una directory del file system.
public:
static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName);public static void ExtractToDirectory (string sourceArchiveFileName, string destinationDirectoryName);static member ExtractToDirectory : string * string -> unitPublic Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String)Parametri
- sourceArchiveFileName
- String
Percorso dell'archivio da estrarre.
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti, specificato come percorso relativo o assoluto. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
Eccezioni
destinationDirectoryName o sourceArchiveFileName è Empty, contiene solo spazi vuoti oppure almeno un carattere non valido.
destinationDirectoryName o sourceArchiveFileName è null.
La lunghezza del percorso specificata in destinationDirectoryName o sourceArchiveFileName supera la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il nome di una voce nell'archivio è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
L'estrazione di una voce dell'archivio crea un file esterno alla directory specificata da destinationDirectoryName. (Ad esempio, si potrebbe verificare se il nome dell'elemento contiene accessori della directory padre).
-oppure-
Una voce di archivio da estrarre ha lo stesso nome di una voce già estratta o presente in destinationDirectoryName.
Il chiamante non dispone dell'autorizzazione necessaria per accedere all'archivio o alla directory di destinazione.
destinationDirectoryName o sourceArchiveFileName contiene un formato non valido.
Il parametro sourceArchiveFileName non è stato trovato.
L'archivio specificato nel parametro sourceArchiveFileName non è un archivio ZIP valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
Una voce dell'archivio è stata compressa con un metodo di compressione non supportato.
Esempio
In questo esempio viene illustrato come creare ed estrarre un archivio zip usando la ZipFile classe . Comprime il contenuto di una cartella in un archivio zip ed estrae il contenuto in una nuova cartella. Per usare la classe ZipFile, è necessario referenziare l'assembly System.IO.Compression.FileSystem nel progetto.
using System;
using System.IO.Compression;
class Program
{
static void Main(string[] args)
{
string startPath = @".\start";
string zipPath = @".\result.zip";
string extractPath = @".\extract";
ZipFile.CreateFromDirectory(startPath, zipPath);
ZipFile.ExtractToDirectory(zipPath, extractPath);
}
}
open System.IO.Compression
let startPath = @".\start"
let zipPath = @".\result.zip"
let extractPath = @".\extract"
ZipFile.CreateFromDirectory(startPath, zipPath)
ZipFile.ExtractToDirectory(zipPath, extractPath)
Imports System.IO.Compression
Module Module1
Sub Main()
Dim startPath As String = ".\start"
Dim zipPath As String = ".\result.zip"
Dim extractPath As String = ".\extract"
ZipFile.CreateFromDirectory(startPath, zipPath)
ZipFile.ExtractToDirectory(zipPath, extractPath)
End Sub
End Module
Commenti
Questo metodo crea la directory specificata e tutte le sottodirectory. La directory di destinazione non può già esistere. Le eccezioni correlate alla convalida dei percorsi nei parametri o sourceArchiveFileName vengono generate prima dell'estrazionedestinationDirectoryName. In caso contrario, se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto. Ogni file estratto ha lo stesso percorso relativo della directory specificata dalla destinationDirectoryName relativa voce di origine deve corrispondere alla radice dell'archivio.
Si applica a
ExtractToDirectory(Stream, String)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system.
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName);public static void ExtractToDirectory (System.IO.Stream source, string destinationDirectoryName);static member ExtractToDirectory : System.IO.Stream * string -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String)Parametri
- source
- Stream
Flusso da cui estrarre l'archivio zip.
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti, specificato come percorso relativo o assoluto. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
Eccezioni
destinationDirectoryName> è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
destinationDirectoryName o source è null.
Il percorso specificato in destinationDirectoryName supera la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il nome di una voce nell'archivio è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
L'estrazione di una voce dell'archivio crea un file esterno alla directory specificata da destinationDirectoryName. (Ad esempio, si potrebbe verificare se il nome dell'elemento contiene accessori della directory padre).
-oppure-
Una voce di archivio da estrarre ha lo stesso nome di una voce già estratta o presente in destinationDirectoryName.
Il chiamante non dispone dell'autorizzazione necessaria per accedere all'archivio o alla directory di destinazione.
destinationDirectoryName o contiene un formato non valido.
L'archivio contenuto nel source flusso non è un archivio zip valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
Una voce dell'archivio è stata compressa con un metodo di compressione non supportato.
Commenti
Questo metodo crea la directory specificata e tutte le sottodirectory. La directory di destinazione non può già esistere. Le eccezioni correlate alla convalida dei percorsi nell'archivio destinationDirectoryName zip contenuti nell'archivio source zip vengono generate prima dell'estrazione. In caso contrario, se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto. Ogni file estratto ha lo stesso percorso relativo della directory specificata dalla destinationDirectoryName relativa voce di origine deve corrispondere alla radice dell'archivio. Se un file da archiviare ha un'ora di ultima modifica non valida, verrà utilizzata la prima data e l'ora rappresentabili nel formato timestamp Zip (mezzanotte il 1° gennaio 1980).
Si applica a
ExtractToDirectory(Stream, String, Encoding)
- Origine:
- ZipFile.Extract.cs
- Origine:
- ZipFile.Extract.cs
Estrae tutti i file dall'archivio zip archiviato nel flusso specificato e li inserisce nella directory di destinazione specificata nel file system e usa la codifica dei caratteri specificata per i nomi di voce.
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding);public static void ExtractToDirectory (System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding);static member ExtractToDirectory : System.IO.Stream * string * System.Text.Encoding -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding)Parametri
- source
- Stream
Flusso da cui estrarre l'archivio zip.
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti, specificato come percorso relativo o assoluto. Un percorso relativo è interpretato rispetto alla directory di lavoro corrente.
- entryNameEncoding
- Encoding
La codifica da utilizzare durante la lettura o la scrittura dei nomi delle voci in questo archivio. Specificare un valore per il parametro solo quando una codifica è obbligatoria per l'interoperabilità con gli strumenti e le librerie dell'archivio ZIP che non supportano la codifica UTF-8 per i nomi di voce.
Eccezioni
destinationDirectoryName> è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
entryNameEncoding è impostato su una codifica Unicode diversa da UTF-8.
destinationDirectoryName o source è null.
Il percorso specificato in destinationDirectoryName supera la lunghezza massima definita dal sistema.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il nome di una voce nell'archivio è Empty, contiene solo spazi vuoti o contiene almeno un carattere non valido.
-oppure-
L'estrazione di una voce dell'archivio crea un file esterno alla directory specificata da destinationDirectoryName. (Ad esempio, si potrebbe verificare se il nome dell'elemento contiene accessori della directory padre).
-oppure-
Una voce di archivio da estrarre ha lo stesso nome di una voce già estratta o presente in destinationDirectoryName.
Il chiamante non dispone dell'autorizzazione necessaria per accedere all'archivio o alla directory di destinazione.
destinationDirectoryName o contiene un formato non valido.
L'archivio contenuto nel source flusso non è un archivio zip valido.
-oppure-
È stato impossibile trovare una voce dell'archivio o era danneggiata.
-oppure-
Una voce dell'archivio è stata compressa con un metodo di compressione non supportato.
Commenti
Questo metodo crea la directory specificata e tutte le sottodirectory. La directory di destinazione non può già esistere. Le eccezioni correlate alla convalida dei percorsi nell'archivio destinationDirectoryName zip contenuti nell'archivio source zip vengono generate prima dell'estrazione. In caso contrario, se si verifica un errore durante l'estrazione, l'archivio rimane parzialmente estratto. Ogni file estratto ha lo stesso percorso relativo della directory specificata dalla destinationDirectoryName relativa voce di origine deve corrispondere alla radice dell'archivio. Se un file da archiviare ha un'ora di ultima modifica non valida, verrà utilizzata la prima data e l'ora rappresentabili nel formato timestamp Zip (mezzanotte il 1° gennaio 1980).
