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.
Extraherar alla filer i arkivet till en katalog i filsystemet. Den angivna katalogen kanske redan finns.
Ö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 kan redan finnas. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
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. Katalogen kan redan finnas. Saknade kataloger skapas efter behov när poster extraheras.
- 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
Varning
Den här metoden får inte användas för att extrahera ej betrodda arkiv. Den tillämpar inga storleksgränser, gränser för antal inmatningar eller andra principer som behövs för säker extrahering av ej betrodda arkiv. Mer information om hur du extraherar arkiv från ej betrodda källor på ett säkert sätt finns i Metodtips för att använda zip- och tjärarkiv.
Katalogen som anges av destinationDirectoryName kan redan finnas. Den här metoden skapar målkatalogen, dess saknade överordnade kataloger och underkataloger efter behov när poster extraheras. Om arkivet är tomt skapar inte den här metoden målkatalogen.
Sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
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 kan redan finnas.
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. Katalogen kan redan finnas. Saknade kataloger skapas efter behov när poster extraheras.
- 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 saknade kataloger efter behov när poster extraheras.
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
Varning
Den här metoden får inte användas för att extrahera ej betrodda arkiv. Den tillämpar inga storleksgränser, gränser för antal inmatningar eller andra principer som behövs för säker extrahering av ej betrodda arkiv. Mer information om hur du extraherar arkiv från ej betrodda källor på ett säkert sätt finns i Metodtips för att använda zip- och tjärarkiv.
Katalogen som anges av destinationDirectoryName kan redan finnas. Den här metoden skapar målkatalogen, dess saknade överordnade kataloger och underkataloger efter behov när poster extraheras. Om arkivet är tomt skapar inte den här metoden målkatalogen.
Sökvägen tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen.
Gäller för
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParametrar
- source
- ZipArchive
- destinationDirectoryName
- String
Sökvägen till katalogen där de extraherade filerna ska lagras. Katalogen kan redan finnas. Saknade kataloger skapas efter behov när poster extraheras.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Returer
Kommentarer
Varning
Den här metoden får inte användas för att extrahera ej betrodda arkiv. Den tillämpar inga storleksgränser, gränser för antal inmatningar eller andra principer som behövs för säker extrahering av ej betrodda arkiv. Mer information om hur du extraherar arkiv från ej betrodda källor på ett säkert sätt finns i Metodtips för att använda zip- och tjärarkiv.
Katalogen som anges av destinationDirectoryName kan redan finnas. Den här metoden skapar målkatalogen, dess saknade överordnade kataloger och underkataloger efter behov när poster extraheras. Om arkivet är tomt skapar inte den här metoden målkatalogen.
Varje extraherad fil har samma relativa sökväg till destinationDirectoryName som källposten har till roten i arkivet.
Parametern destinationDirectoryName accepterar relativa och absoluta sökvägar. En relativ sökväg tolkas som relativ till den aktuella arbetskatalogen.
Om ett fel uppstår under extraheringen förblir arkivet delvis extraherat.
Ange OverwriteFiles till för att true skriva över befintliga filer. Standardvärdet är false, vilket gör att extrahering genererar en IOException om det redan finns en fil som ska extraheras.
Använd Password för att ange lösenordet för krypterade poster.
EntryNameEncoding används inte av den här överlagringen. Postnamn och kommentarer avkodas med den kodning som angavs när arkivet source öppnades.
Symboliska länkar i arkivet återskapas inte som symboliska länkar. Om destinationDirectoryName eller någon av dess överordnade kataloger är en befintlig koppling eller symbolisk länk följs länken och extraheringsskrivningar till den slutliga målmappen.
Undantag som inträffar under asynkron extrahering lagras i den returnerade aktiviteten och genereras när uppgiften väntar.
