ZipFileExtensions.ExtractToDirectoryAsync Metoda

Definice

Obor názvů:

System.IO.Compression

Sestavení:

netstandard.dll, System.IO.Compression.ZipFile.dll

Přetížení

Name	Description
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)	Asynchronně extrahuje všechny soubory v archivu do adresáře v systému souborů. Zadaný adresář již může existovat.
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)	Extrahuje všechny soubory v archivu do adresáře v systému souborů. Zadaný adresář již může existovat.

ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)

Zdroj:

ZipFileExtensions.ZipArchive.Extract.Async.cs

Asynchronně extrahuje všechny soubory v archivu do adresáře v systému souborů. Zadaný adresář již může existovat.

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 Task

Parametry

source

ZipArchive

Archiv zip pro extrahování souborů.

destinationDirectoryName

String

Cesta k adresáři v systému souborů.

cancellationToken

CancellationToken

Token zrušení, který se má monitorovat pro žádosti o zrušení.

Návraty

Task

Výjimky

ArgumentException

destinationDirectoryName je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků definovaných hodnotou InvalidPathChars.

ArgumentNullException

destinationDirectoryName je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem. Například na platformách s Windows musí být cesty kratší než 248 znaků a názvy souborů musí být menší než 260 znaků.

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nenamapované jednotce).

IOException

Název položky archivu je nulová délka, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků definovaných hodnotou InvalidPathChars.

nebo

Extrahování položky archivu by vedlo k tomu, že cílový soubor je mimo ( destinationDirectoryName například pokud název položky obsahuje nadřazené přístupové objekty adresáře).

nebo

Položka archivu má stejný název jako již extrahovaná položka ze stejného archivu.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

NotSupportedException

destinationDirectoryName je v neplatném formátu.

InvalidDataException

Položka archivu nebyla nalezena nebo je poškozena.

nebo

Položka archivu byla komprimována pomocí metody komprese, která není podporována.

OperationCanceledException

Asynchronní operace se zruší.

Poznámky

Zadaný adresář nesmí existovat. Cesta je povolena k zadání relativních nebo absolutních informací o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři.

Tato metoda v případě potřeby vytvoří všechny podadresáře a zadaný adresář.

Pokud při extrahování archivu dojde k chybě, archiv zůstane částečně extrahovaný.

Každá položka se extrahuje tak, že extrahovaný soubor má stejnou relativní cestu, ke destinationDirectoryName které má položka kořen archivu. Pokud má archivovaný soubor neplatný čas poslední změny, použije se první datum a čas představující ve formátu zip časového razítka (půlnoc 1. ledna 1980).

ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)

Zdroj:

ZipFileExtensions.ZipArchive.Create.cs

Extrahuje všechny soubory v archivu do adresáře v systému souborů. Zadaný adresář již může existovat.

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 Task

Parametry

source

ZipArchive

Archiv zip pro extrahování souborů.

destinationDirectoryName

String

Cesta k adresáři v systému souborů.

overwriteFiles

Boolean

true přepsání souborů; false Jinak.

cancellationToken

CancellationToken

Token zrušení, který se má monitorovat pro žádosti o zrušení.

Návraty

Task

Výjimky

ArgumentException

destinationDirectoryName je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků definovaných hodnotou InvalidPathChars.

Tato metoda v případě potřeby vytvoří všechny podadresáře a zadaný adresář.

Pokud při extrahování archivu dojde k chybě, archiv zůstane částečně extrahovaný.

Každá položka se extrahuje tak, že extrahovaný soubor má stejnou relativní cestu, ke destinationDirectoryName které má položka kořen archivu. Pokud má archivovaný soubor neplatný čas poslední změny, použije se první datum a čas představující ve formátu zip časového razítka (půlnoc 1. ledna 1980).

ArgumentNullException

destinationDirectoryName je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Například na platformách s Windows musí být cesty kratší než 248 znaků a názvy souborů musí být menší než 260 znaků.

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nenamapované jednotce).

IOException

Název položky archivu je nulová délka, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků definovaných hodnotou InvalidPathChars.

nebo

Extrahování položky archivu by vedlo k tomu, že cílový soubor je mimo ( destinationDirectoryName například pokud název položky obsahuje nadřazené přístupové objekty adresáře).

nebo

Položka archivu má stejný název jako již extrahovaná položka ze stejného archivu.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

NotSupportedException

destinationDirectoryName je v neplatném formátu.

InvalidDataException

Položka archivu nebyla nalezena nebo byla poškozena.

nebo

Položka archivu byla komprimována pomocí metody komprese, která není podporována.

Poznámky

Zadaný adresář nesmí existovat. Cesta je povolena k zadání relativních nebo absolutních informací o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři.