ZipFileExtensions.ExtractToFileAsync 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 |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Asynkront skapar en fil i filsystemet med postens innehåll och det angivna namnet. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Asynkront skapar en fil i filsystemet med postens innehåll och det angivna namnet. |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
Asynkront skapar en fil i filsystemet med postens innehåll och det angivna namnet.
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 TaskParametrar
- source
- ZipArchiveEntry
Post för zip-arkiv för att extrahera en fil från.
- destinationFileName
- String
Namnet på filen som innehåller innehållet i posten.
- cancellationToken
- CancellationToken
Den annulleringstoken som ska övervakas för annulleringsbegäranden.
Returer
Undantag
Anroparen har inte den behörighet som krävs.
destinationFileName ä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-
destinationFileName anger en katalog.
destinationFileName är null.
Den angivna sökvägen, filnamnet eller båda överskrider 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.
Sökvägen som anges i destinationFileName är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel har inträffat.
-eller-
Posten är för närvarande öppen för skrivning.
-eller-
Posten har tagits bort från arkivet.
destinationFileName är i ett ogiltigt format.
-eller-
ZipArchive som den här posten tillhör öppnades i skrivskyddat läge.
Posten saknas i arkivet eller är skadad och kan inte läsas.
-eller-
Posten har komprimerats med en komprimeringsmetod som inte stöds.
ZipArchive som den här posten tillhör har tagits bort.
Kommentarer
Den angivna sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
Den sista skrivtiden för filen är inställd på postens senaste skrivtid. Den här metoden tillåter inte överskrivning av en befintlig fil med samma namn. Om du försöker extrahera explicita kataloger (poster med namn som slutar med katalogavgränsningstecken) skapas inte en katalog.
Gäller för
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
Asynkront skapar en fil i filsystemet med postens innehåll och det angivna namnet.
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 TaskParametrar
- source
- ZipArchiveEntry
Post för zip-arkiv för att extrahera en fil från.
- destinationFileName
- String
Namnet på filen som innehåller innehållet i posten.
- overwrite
- Boolean
true för att skriva över filer; false Annars.
- cancellationToken
- CancellationToken
Den annulleringstoken som ska övervakas för annulleringsbegäranden.
Returer
Undantag
Anroparen har inte den behörighet som krävs.
destinationFileName ä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-
destinationFileName anger en katalog.
destinationFileName är null.
Den angivna sökvägen, filnamnet eller båda överskrider 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.
Sökvägen som anges i destinationFileName är ogiltig (den finns till exempel på en ommappad enhet).
Ett I/O-fel har inträffat.
-eller-
Posten är för närvarande öppen för skrivning.
-eller-
Posten har tagits bort från arkivet.
destinationFileName är i ett ogiltigt format.
-eller-
ZipArchive som den här posten tillhör öppnades i skrivskyddat läge.
Posten saknas i arkivet eller är skadad och kan inte läsas.
-eller-
Posten har komprimerats med en komprimeringsmetod som inte stöds.
ZipArchive som den här posten tillhör har tagits bort.
En asynkron åtgärd avbryts.
Kommentarer
Den angivna sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
Den sista skrivtiden för filen är inställd på postens senaste skrivtid.
Den här metoden tillåter överskrivning av en befintlig fil med samma namn.
