ZipFileExtensions.CreateEntryFromFileAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Lägger asynkront till en fil från filsystemet i arkivet under det angivna postnamnet. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Lägger asynkront till en fil från filsystemet i arkivet under det angivna postnamnet. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Lägger asynkront till en fil från filsystemet i arkivet under det angivna postnamnet.
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)Parametrar
- destination
- ZipArchive
Zip-arkivet som filen ska läggas till i.
- sourceFileName
- String
Sökvägen till filen i filsystemet som ska kopieras från. Sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
- entryName
- String
Namnet på posten som ska skapas.
- cancellationToken
- CancellationToken
Den annulleringstoken som ska övervakas för annulleringsbegäranden.
Returer
En omslutning för den nyligen skapade posten.
Undantag
sourceFileName är en sträng med noll längd, innehåller endast blanksteg eller innehåller ett eller flera ogiltiga tecken som definierats av InvalidPathChars.
-eller-
entryName är en sträng med noll längd.
sourceFileName eller entryName är null.
I sourceFileNameöverskrider den angivna sökvägen, filnamnet eller båda den systemdefinierade maximala längden. På Windows-baserade plattformar måste sökvägar till exempel vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.
Den angivna sourceFileName är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel uppstod när filen som angetts av öppnades.sourceFileName
sourceFileName har angett en katalog.
-eller-
Anroparen har inte den behörighet som krävs.
Filen som angavs i sourceFileName hittades inte.
sourceFileName är i ett ogiltigt format eller så har ZipArchive inte stöd för skrivning.
ZipArchive har redan stängts.
En asynkron åtgärd avbryts.
Kommentarer
Den nya posten i arkivet innehåller innehållet i filen.
Den sista skrivtiden för arkivposten är inställd på den sista skrivtiden för filen i filsystemet.
Om det redan finns en post med det angivna namnet i arkivet skapas en andra post som har ett identiskt namn.
Om den angivna källfilen har en ogiltig senast ändrad tid används den första datetime som kan representeras i Zip-tidsstämpelformatet (midnatt den 1 januari 1980). Om det redan finns en post med det angivna namnet i arkivet skapas en andra post som har ett identiskt namn. Eftersom nej CompressionLevel har angetts används standardinställningen som tillhandahålls av implementeringen av den underliggande komprimeringsalgoritmen ZipArchive . Den tillämpar inte sin egen standard.
(För närvarande tillhandahålls den underliggande komprimeringsalgoritmen DeflateStream av klassen.)
Gäller för
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Lägger asynkront till en fil från filsystemet i arkivet under det angivna postnamnet.
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)Parametrar
- destination
- ZipArchive
Zip-arkivet som filen ska läggas till i.
- sourceFileName
- String
Sökvägen till filen i filsystemet som ska kopieras från. Sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
- entryName
- String
Namnet på posten som ska skapas.
- compressionLevel
- CompressionLevel
Komprimeringsnivån (hastighet/minne jämfört med komprimerad storleksutjämning).
- cancellationToken
- CancellationToken
Den annulleringstoken som ska övervakas för annulleringsbegäranden.
Returer
En omslutning för den nyligen skapade posten.
Undantag
sourceFileName är en sträng med noll längd, innehåller endast blanksteg eller innehåller ett eller flera ogiltiga tecken som definierats av InvalidPathChars.
-eller-
entryName är en sträng med noll längd.
sourceFileName eller entryName är null.
I sourceFileNameöverskrider den angivna sökvägen, filnamnet eller båda den systemdefinierade maximala längden. På Windows-baserade plattformar måste sökvägar till exempel vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.
Den angivna sourceFileName är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel uppstod när filen som angetts av öppnades.sourceFileName
sourceFileName har angett en katalog.
-eller-
Anroparen har inte den behörighet som krävs.
Filen som angavs i sourceFileName hittades inte.
sourceFileName är i ett ogiltigt format eller så har ZipArchive inte stöd för skrivning.
ZipArchive har redan stängts.
En asynkron åtgärd avbryts.
Kommentarer
Den nya posten i arkivet innehåller innehållet i filen.
Den sista skrivtiden för arkivposten är inställd på den sista skrivtiden för filen i filsystemet.
Om det redan finns en post med det angivna namnet i arkivet skapas en andra post som har ett identiskt namn.
Om den angivna källfilen har en ogiltig senast ändrad tid används den första datetime som kan representeras i Zip-tidsstämpelformatet (midnatt den 1 januari 1980). Om det redan finns en post med det angivna namnet i arkivet skapas en andra post som har ett identiskt namn.
