ZipFileExtensions.CreateEntryFromFileAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Name | Description |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Asynchronně přidá soubor ze systému souborů do archivu pod zadaný název položky. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Asynchronně přidá soubor ze systému souborů do archivu pod zadaný název položky. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Asynchronně přidá soubor ze systému souborů do archivu pod zadaný název položky.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parametry
- destination
- ZipArchive
Archiv zip, do které chcete soubor přidat.
- sourceFileName
- String
Cesta k souboru v systému souborů, ze které se má kopírovat. 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.
- entryName
- String
Název položky, která se má vytvořit.
- cancellationToken
- CancellationToken
Token zrušení, který se má monitorovat pro žádosti o zrušení.
Návraty
Obálka pro nově vytvořenou položku
Výjimky
sourceFileName 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
entryName je řetězec nulové délky.
sourceFileName nebo entryName je null.
Zadaná sourceFileNamecesta, název souboru nebo obojí překročí 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ů.
Zadaná sourceFileName hodnota je neplatná (například je na nenamapované jednotce).
Při otevírání souboru určeného uživatelem sourceFileNamedošlo k chybě vstupně-výstupní operace.
Soubor zadaný v sourceFileName souboru nebyl nalezen.
sourceFileName je v neplatném formátu nebo zipArchive nepodporuje zápis.
ZipArchive už je zavřený.
Asynchronní operace se zruší.
Poznámky
Nová položka v archivu bude obsahovat obsah souboru.
Čas posledního zápisu položky archivu je nastaven na čas posledního zápisu souboru v systému souborů.
Pokud položka se zadaným názvem již v archivu existuje, vytvoří se druhá položka, která má stejný název.
Pokud má zadaný zdrojový soubor neplatný čas poslední změny, použije se první datum a čas představující ve formátu časového razítka ZIP (půlnoc 1. ledna 1980). Pokud položka se zadaným názvem již v archivu existuje, vytvoří se druhá položka, která má stejný název. Vzhledem k tomu, že není zadána žádná CompressionLevel hodnota, použije se výchozí hodnota poskytovaná implementací podkladového algoritmu komprese; ZipArchive neuloží vlastní výchozí hodnotu.
(V současné době je základní algoritmus komprese poskytován DeflateStream třídou.)
Platí pro
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Asynchronně přidá soubor ze systému souborů do archivu pod zadaný název položky.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parametry
- destination
- ZipArchive
Archiv zip, do které chcete soubor přidat.
- sourceFileName
- String
Cesta k souboru v systému souborů, ze které se má kopírovat. 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.
- entryName
- String
Název položky, která se má vytvořit.
- compressionLevel
- CompressionLevel
Úroveň komprese (rychlost/paměť oproti kompromisu komprimované velikosti).
- cancellationToken
- CancellationToken
Token zrušení, který se má monitorovat pro žádosti o zrušení.
Návraty
Obálka pro nově vytvořenou položku
Výjimky
sourceFileName 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
entryName je řetězec nulové délky.
sourceFileName nebo entryName je null.
Zadaná sourceFileNamecesta, název souboru nebo obojí překročí 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ů.
Zadaná sourceFileName hodnota je neplatná (například je na nenamapované jednotce).
Při otevírání souboru určeného uživatelem sourceFileNamedošlo k chybě vstupně-výstupní operace.
Soubor zadaný v sourceFileName souboru nebyl nalezen.
sourceFileName je v neplatném formátu nebo zipArchive nepodporuje zápis.
ZipArchive už je zavřený.
Asynchronní operace se zruší.
Poznámky
Nová položka v archivu bude obsahovat obsah souboru.
Čas posledního zápisu položky archivu je nastaven na čas posledního zápisu souboru v systému souborů.
Pokud položka se zadaným názvem již v archivu existuje, vytvoří se druhá položka, která má stejný název.
Pokud má zadaný zdrojový soubor neplatný čas poslední změny, použije se první datum a čas představující ve formátu časového razítka ZIP (půlnoc 1. ledna 1980). Pokud položka se zadaným názvem již v archivu existuje, vytvoří se druhá položka, která má stejný název.
