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(Stream, String, TarExtractOptions) | |
| ExtractToDirectory(String, String, Boolean) |
Estrae il contenuto di un file tar nella directory specificata. |
| ExtractToDirectory(String, String, TarExtractOptions) |
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. In .NET 11 e versioni precedenti, la directory deve già esistere. In .NET 12 e versioni successive, le directory di destinazione e padre mancanti vengono create in base alle esigenze quando vengono estratte le voci. Un archivio vuoto non crea alcuna directory.
- 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.
.NET 11 e versioni precedenti: la destinationDirectoryName directory non esiste.
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
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.
In .NET 11 e versioni precedenti, la directory specificata da destinationDirectoryName deve già esistere. Se non esiste, questo metodo genera un'eccezione DirectoryNotFoundException, anche se l'archivio è vuoto.
In .NET 12 e versioni successive la directory di destinazione può già esistere. Le directory di destinazione e padre mancanti vengono create in base alle esigenze quando le voci vengono estratte. Un archivio vuoto non crea directory.
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.
Si applica a
ExtractToDirectory(Stream, String, TarExtractOptions)
- Origine:
- TarFile.cs
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);static member ExtractToDirectory : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)Parametri
- source
- Stream
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti. In .NET 11 e versioni precedenti, la directory deve già esistere. In .NET 12 e versioni successive, le directory di destinazione e padre mancanti vengono create in base alle esigenze quando vengono estratte le voci. Un archivio vuoto non crea alcuna directory.
- options
- TarExtractOptions
Eccezioni
.NET 11 e versioni precedenti: la destinationDirectoryName directory non esiste.
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.
In .NET 11 e versioni precedenti, la directory specificata da destinationDirectoryName deve già esistere. Se non esiste, questo metodo genera un'eccezione DirectoryNotFoundException, anche se l'archivio è vuoto.
In .NET 12 e versioni successive la directory di destinazione può già esistere. Le directory di destinazione e padre mancanti vengono create in base alle esigenze quando le voci vengono estratte. Un archivio vuoto non crea directory.
Il percorso può essere relativo o assoluto. 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. Usare HardLinkMode per controllare la modalità di estrazione delle voci di collegamento rigido.
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.
Il source flusso viene lasciato aperto dopo l'estrazione.
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. In .NET 11 e versioni precedenti, la directory deve già esistere. In .NET 12 e versioni successive, le directory di destinazione e padre mancanti vengono create in base alle esigenze quando vengono estratte le voci. Un archivio vuoto non crea alcuna directory.
- 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.
.NET 11 e versioni precedenti: la destinationDirectoryName directory non esiste.
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
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.
In .NET 11 e versioni precedenti, la directory specificata da destinationDirectoryName deve già esistere. Se non esiste, questo metodo genera un'eccezione DirectoryNotFoundException, anche se l'archivio è vuoto.
In .NET 12 e versioni successive la directory di destinazione può già esistere. Le directory di destinazione e padre mancanti vengono create in base alle esigenze quando le voci vengono estratte. Un archivio vuoto non crea directory.
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.
Si applica a
ExtractToDirectory(String, String, TarExtractOptions)
- Origine:
- TarFile.cs
public:
static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);static member ExtractToDirectory : string * string * System.Formats.Tar.TarExtractOptions -> unitPublic Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)Parametri
- sourceFileName
- String
- destinationDirectoryName
- String
Percorso della directory in cui inserire i file estratti. In .NET 11 e versioni precedenti, la directory deve già esistere. In .NET 12 e versioni successive, le directory di destinazione e padre mancanti vengono create in base alle esigenze quando vengono estratte le voci. Un archivio vuoto non crea alcuna directory.
- options
- TarExtractOptions
Eccezioni
.NET 11 e versioni precedenti: la destinationDirectoryName directory non esiste.
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.
In .NET 11 e versioni precedenti, la directory specificata da destinationDirectoryName deve già esistere. Se non esiste, questo metodo genera un'eccezione DirectoryNotFoundException, anche se l'archivio è vuoto.
In .NET 12 e versioni successive la directory di destinazione può già esistere. Le directory di destinazione e padre mancanti vengono create in base alle esigenze quando le voci vengono estratte. Un archivio vuoto non crea directory.
Il percorso può essere relativo o assoluto. 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. Usare HardLinkMode per controllare la modalità di estrazione delle voci di collegamento rigido.
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.
