ZipFileExtensions.ExtractToDirectoryAsync 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 |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extraherar asynkront alla filer i arkivet till en katalog i filsystemet. Den angivna katalogen kan redan finnas. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extraherar alla filer i arkivet till en katalog i filsystemet. Den angivna katalogen kanske redan finns. |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Extraherar asynkront alla filer i arkivet till en katalog i filsystemet. Den angivna katalogen kan redan finnas.
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 TaskParametrar
- source
- ZipArchive
Zip-arkivet som du vill extrahera filer från.
- destinationDirectoryName
- String
Sökvägen till katalogen i filsystemet.
- cancellationToken
- CancellationToken
Den annulleringstoken som ska övervakas för annulleringsbegäranden.
Returer
Undantag
destinationDirectoryName är en sträng med noll längd, innehåller endast blanksteg eller innehåller ett eller flera ogiltiga tecken som definierats av InvalidPathChars.
destinationDirectoryName ä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.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
En arkivposts namn är noll längd, innehåller endast blanksteg eller innehåller ett eller flera ogiltiga tecken som definierats av InvalidPathChars.
-eller-
Om du extraherade en arkivpost skulle det ha resulterat i en målfil som ligger utanför destinationDirectoryName (till exempel om postnamnet innehåller överordnade katalogåtkomster).
-eller-
En arkivpost har samma namn som en redan extraherad post från samma arkiv.
Anroparen har inte den behörighet som krävs.
destinationDirectoryName är i ett ogiltigt format.
En arkivpost hittades inte eller är skadad.
-eller-
En arkivpost har komprimerats med en komprimeringsmetod som inte stöds.
En asynkron åtgärd avbryts.
Kommentarer
Den angivna katalogen får inte finnas. Sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
Den här metoden skapar alla underkataloger och den angivna katalogen om det behövs.
Om det uppstår ett fel när arkivet extraheras förblir arkivet delvis extraherat.
Varje post extraheras så att den extraherade filen har samma relativa sökväg till destinationDirectoryName som posten har till roten i arkivet. Om en fil som ska arkiveras har en ogiltig senast ändrad tid används den första datetime som kan representeras i Zip-tidsstämpelformatet (midnatt den 1 januari 1980).
Gäller för
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Extraherar alla filer i arkivet till en katalog i filsystemet. Den angivna katalogen kanske redan finns.
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 TaskParametrar
- source
- ZipArchive
Zip-arkivet som du vill extrahera filer från.
- destinationDirectoryName
- String
Sökvägen till katalogen i filsystemet.
- overwriteFiles
- Boolean
true för att skriva över filer; false Annars.
- cancellationToken
- CancellationToken
Den annulleringstoken som ska övervakas för annulleringsbegäranden.
Returer
Undantag
destinationDirectoryName är en sträng med noll längd, innehåller endast blanksteg eller innehåller ett eller flera ogiltiga tecken som definierats av InvalidPathChars.
Den här metoden skapar alla underkataloger och den angivna katalogen om det behövs.
Om det uppstår ett fel när arkivet extraheras förblir arkivet delvis extraherat.
Varje post extraheras så att den extraherade filen har samma relativa sökväg till destinationDirectoryName som posten har till roten i arkivet. Om en fil som ska arkiveras har en ogiltig senast ändrad tid används den första datetime som kan representeras i Zip-tidsstämpelformatet (midnatt den 1 januari 1980).
destinationDirectoryName ä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.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
En arkivposts namn är noll längd, innehåller endast blanksteg eller innehåller ett eller flera ogiltiga tecken som definierats av InvalidPathChars.
-eller-
Om du extraherade en arkivpost skulle det ha resulterat i en målfil som ligger utanför destinationDirectoryName (till exempel om postnamnet innehåller överordnade katalogåtkomster).
-eller-
En arkivpost har samma namn som en redan extraherad post från samma arkiv.
Anroparen har inte den behörighet som krävs.
destinationDirectoryName är i ett ogiltigt format.
En arkivpost hittades inte eller var skadad.
-eller-
En arkivpost har komprimerats med en komprimeringsmetod som inte stöds.
Kommentarer
Den angivna katalogen får inte finnas. Sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
