ZipFileExtensions.ExtractToFileAsync Metoda

Definice

Obor názvů:

System.IO.Compression

Sestavení:

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

Přetížení

Name	Description
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)	Asynchronně vytvoří soubor v systému souborů s obsahem položky a zadaným názvem.
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)	Asynchronně vytvoří soubor v systému souborů s obsahem položky a zadaným názvem.

ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)

Zdroj:

ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Asynchronně vytvoří soubor v systému souborů s obsahem položky a zadaným názvem.

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

source

ZipArchiveEntry

Položka archivu zip pro extrahování souboru z.

destinationFileName

String

Název souboru, který bude obsahovat obsah položky.

cancellationToken

CancellationToken

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

Návraty

Task

Výjimky

UnauthorizedAccessException

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

ArgumentException

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

nebo

destinationFileName určuje adresář.

ArgumentNullException

destinationFileName 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

Cesta zadaná v destinationFileName tomto umístění je neplatná (například je na nemapované jednotce).

IOException

Došlo k vstupně-výstupní chybě.

nebo

Položka je aktuálně otevřená pro psaní.

nebo

Položka byla odstraněna z archivu.

NotSupportedException

destinationFileName je v neplatném formátu.

nebo

ZipArchive, do kterého tato položka patří, byla otevřena v režimu jen pro zápis.

InvalidDataException

Položka v archivu chybí nebo je poškozená a nelze ji přečíst.

nebo

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

ObjectDisposedException

ZipArchive, ke které tato položka patří, byla odstraněna.

Poznámky

Zadaná cesta umožňuje zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři.

Čas posledního zápisu souboru je nastavený na čas posledního zápisu položky. Tato metoda neumožňuje přepis existujícího souboru se stejným názvem. Při pokusu o extrahování explicitních adresářů (položek s názvy, které končí znaky oddělovače adresářů) nebude vytvoření adresáře.

ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)

Zdroj:

ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Asynchronně vytvoří soubor v systému souborů s obsahem položky a zadaným názvem.

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

source

ZipArchiveEntry

Položka archivu zip pro extrahování souboru z.

destinationFileName

String

Název souboru, který bude obsahovat obsah položky.

overwrite

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

UnauthorizedAccessException

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

ArgumentException

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

nebo

destinationFileName určuje adresář.

ArgumentNullException

destinationFileName 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

Cesta zadaná v destinationFileName tomto umístění je neplatná (například je na nemapované jednotce).

IOException

Došlo k vstupně-výstupní chybě.

nebo

Položka je aktuálně otevřená pro psaní.

nebo

Položka byla odstraněna z archivu.

NotSupportedException

destinationFileName je v neplatném formátu.

nebo

ZipArchive, do kterého tato položka patří, byla otevřena v režimu jen pro zápis.

InvalidDataException

Položka v archivu chybí nebo je poškozená a nelze ji přečíst.

nebo

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

ObjectDisposedException

ZipArchive, ke které tato položka patří, byla odstraněna.

OperationCanceledException

Asynchronní operace se zruší.

Poznámky

Zadaná cesta umožňuje zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři.

Čas posledního zápisu souboru je nastavený na čas posledního zápisu položky.

Tato metoda umožňuje přepis existujícího souboru se stejným názvem.