TarFile.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(String, String, Boolean, CancellationToken) |
Estrae in modo asincrono il contenuto di un file tar nella directory specificata. |
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
Estrae in modo asincrono il contenuto di un flusso che rappresenta un archivio tar nella directory specificata. |
| ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken) | |
| ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken) |
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
Estrae in modo asincrono il contenuto di un file tar nella directory specificata.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- 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.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Attività che rappresenta l'operazione di estrazione asincrona.
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.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ExtractToDirectory(String, String, Boolean).
Si applica a
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
- Origine:
- TarFile.cs
Estrae in modo asincrono il contenuto di un flusso che rappresenta un archivio tar nella directory specificata.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- 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.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Attività che rappresenta l'operazione di estrazione asincrona.
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.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ExtractToDirectory(Stream, String, Boolean).
Si applica a
ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken)
- Origine:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- 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
- cancellationToken
- CancellationToken
Valori restituiti
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.
Le eccezioni che si verificano durante l'estrazione asincrona vengono archiviate nell'attività restituita e vengono generate quando l'attività è attesa.
Si applica a
ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken)
- Origine:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- 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
- cancellationToken
- CancellationToken
Valori restituiti
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.
Le eccezioni che si verificano durante l'estrazione asincrona vengono archiviate nell'attività restituita e vengono generate quando l'attività è attesa.
