TarFile.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.
Overload
| Nome | Descrizione |
|---|---|
| ExtractToDirectory(Stream, String, Boolean) |
Estrae il contenuto di un flusso che rappresenta un archivio tar nella directory specificata. |
| ExtractToDirectory(String, String, Boolean) |
Estrae il contenuto di un file tar nella directory specificata. |
ExtractToDirectory(Stream, String, Boolean)
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
Estrae il contenuto di un flusso che rappresenta un archivio tar nella directory specificata.
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 contenente l'archivio tar.
- destinationDirectoryName
- String
Percorso della directory di destinazione in cui devono essere estratte le voci del file system.
- overwriteFiles
- Boolean
true per sovrascrivere file e directory in destinationDirectoryName, false per evitare la sovrascrittura e generare se vengono trovati file o directory con nomi esistenti.
Eccezioni
source o destinationDirectoryName è null.
Il percorso della destinationDirectoryName directory non viene trovato.
Le autorizzazioni non sono sufficienti.
L'estrazione di una delle voci tar avrebbe generato un file all'esterno della directory di destinazione specificata.
oppure
destinationDirectoryName è vuoto.
oppure
source non supporta la lettura.
Solo .NET 11 e versioni successive: il checksum di una voce non è valido.
Si è verificata un'eccezione di I/O.
Commenti
Se un collegamento simbolico o una giunzione nell'archivio tar comporta l'estrazione di un file all'esterno dell'oggetto specificato destinationDirectoryName, viene generata un'eccezione IOException per garantire che l'estrazione rimanga all'interno della stessa directory.
Se destinationDirectoryName o una delle directory padre è una giunzione preesistente o un collegamento simbolico, viene seguito il collegamento e l'estrazione scrive nella cartella di destinazione finale.
I file di tipo BlockDevice, CharacterDeviceo Fifo possono essere estratti solo nelle piattaforme Unix.
L'elevazione dei privilegi è necessaria per estrarre un BlockDevice oggetto o CharacterDevice su disco.
Questo metodo non limita le dimensioni totali estratte o il numero di voci estratte dall'archivio. Durante l'elaborazione degli archivi da origini non attendibili, eseguire l'iterazione delle voci manualmente usando TarReadere verificare che le dimensioni e il numero di voci siano entro limiti accettabili per lo scenario.
Si applica a
ExtractToDirectory(String, String, Boolean)
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
Estrae il contenuto di un file tar nella directory specificata.
public:
static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, bool overwriteFiles);static member ExtractToDirectory : string * string * bool -> unitPublic Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)Parametri
- sourceFileName
- String
Percorso del file tar da estrarre.
- destinationDirectoryName
- String
Percorso della directory di destinazione in cui devono essere estratte le voci del file system.
- overwriteFiles
- Boolean
true per sovrascrivere file e directory in destinationDirectoryName, false per evitare la sovrascrittura e generare se vengono trovati file o directory con nomi esistenti.
Eccezioni
sourceFileName o destinationDirectoryName è null.
Il percorso della destinationDirectoryName directory non viene trovato.
Il percorso del sourceFileName file non viene trovato.
Le autorizzazioni non sono sufficienti.
L'estrazione di una delle voci tar avrebbe generato un file all'esterno della directory di destinazione specificata.
oppure
sourceFileName o destinationDirectoryName è vuoto.
Solo .NET 11 e versioni successive: il checksum di una voce non è valido.
Si è verificata un'eccezione di I/O.
Commenti
Se un collegamento simbolico o una giunzione nell'archivio tar comporta l'estrazione di un file all'esterno dell'oggetto specificato destinationDirectoryName, viene generata un'eccezione IOException per garantire che l'estrazione rimanga all'interno della stessa directory.
Se destinationDirectoryName o una delle directory padre è una giunzione preesistente o un collegamento simbolico, viene seguito il collegamento e l'estrazione scrive nella cartella di destinazione finale.
I file di tipo BlockDevice, CharacterDeviceo Fifo possono essere estratti solo nelle piattaforme Unix.
L'elevazione dei privilegi è necessaria per estrarre un BlockDevice oggetto o CharacterDevice su disco.
Questo metodo non limita le dimensioni totali estratte o il numero di voci estratte dall'archivio. Durante l'elaborazione degli archivi da origini non attendibili, eseguire l'iterazione delle voci manualmente usando TarReadere verificare che le dimensioni e il numero di voci siano entro limiti accettabili per lo scenario.
