ZipFileExtensions.ExtractToDirectoryAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee worden alle bestanden in het archief geëxtraheerd naar een map in het bestandssysteem. De opgegeven map bestaat mogelijk al.
Overloads
| Naam | Description |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Alle bestanden in het archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem. De opgegeven map kan al bestaan. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Hiermee worden alle bestanden in het archief geëxtraheerd naar een map in het bestandssysteem. De opgegeven map kan al bestaan. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Alle bestanden in het archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem. De opgegeven map kan al bestaan.
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 TaskParameters
- source
- ZipArchive
Het zip-archief waaruit bestanden moeten worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map in het bestandssysteem. De map kan al bestaan. Ontbrekende mappen worden indien nodig gemaakt bij het extraheren van vermeldingen.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
destinationDirectoryName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
destinationDirectoryName is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte. Op Windows platforms moeten paden bijvoorbeeld kleiner zijn dan 248 tekens en moeten bestandsnamen kleiner zijn dan 260 tekens.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
De naam van een archiefvermelding is nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
– of –
Het extraheren van een archiefvermelding zou hebben geresulteerd in een doelbestand dat zich buiten destinationDirectoryName bevindt (bijvoorbeeld als de vermeldingsnaam bovenliggende maptoegangsors bevat).
– of –
Een archiefvermelding heeft dezelfde naam als een al geëxtraheerde vermelding uit hetzelfde archief.
De beller heeft niet de vereiste machtiging.
destinationDirectoryName heeft een ongeldige indeling.
Er is geen archiefvermelding gevonden of is beschadigd.
– of –
Een archiefvermelding is gecomprimeerd met behulp van een compressiemethode die niet wordt ondersteund.
Een asynchrone bewerking wordt geannuleerd.
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
De map die is opgegeven door destinationDirectoryName kan al bestaan. Met deze methode maakt u de doelmap, de ontbrekende bovenliggende mappen en submappen indien nodig bij het extraheren van vermeldingen. Als het archief leeg is, maakt deze methode de doelmap niet.
Het pad mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als er een fout optreedt tijdens het extraheren van het archief, blijft het archief gedeeltelijk geëxtraheerd.
Elke vermelding wordt geëxtraheerd, zodat het uitgepakte bestand hetzelfde relatieve pad destinationDirectoryName heeft als de vermelding in de hoofdmap van het archief. Als een te archiveren bestand een ongeldige tijd voor het laatst gewijzigd heeft, wordt de eerste datum/tijd weergegeven in de zip-tijdstempelnotatie (middernacht op 1 januari 1980).
Van toepassing op
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Hiermee worden alle bestanden in het archief geëxtraheerd naar een map in het bestandssysteem. De opgegeven map kan al bestaan.
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 TaskParameters
- source
- ZipArchive
Het zip-archief waaruit bestanden moeten worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map in het bestandssysteem. De map kan al bestaan. Ontbrekende mappen worden indien nodig gemaakt bij het extraheren van vermeldingen.
- overwriteFiles
- Boolean
true bestanden te overschrijven; false Anders.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
destinationDirectoryName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
Met deze methode worden ontbrekende mappen gemaakt wanneer u vermeldingen extraheert.
Als er een fout optreedt tijdens het extraheren van het archief, blijft het archief gedeeltelijk geëxtraheerd.
Elke vermelding wordt geëxtraheerd, zodat het uitgepakte bestand hetzelfde relatieve pad destinationDirectoryName heeft als de vermelding in de hoofdmap van het archief. Als een te archiveren bestand een ongeldige tijd voor het laatst gewijzigd heeft, wordt de eerste datum/tijd weergegeven in de zip-tijdstempelnotatie (middernacht op 1 januari 1980).
destinationDirectoryName is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Op Windows platforms moeten paden bijvoorbeeld kleiner zijn dan 248 tekens en moeten bestandsnamen kleiner zijn dan 260 tekens.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
De naam van een archiefvermelding is nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
– of –
Het extraheren van een archiefvermelding zou hebben geresulteerd in een doelbestand dat zich buiten destinationDirectoryName bevindt (bijvoorbeeld als de vermeldingsnaam bovenliggende maptoegangsors bevat).
– of –
Een archiefvermelding heeft dezelfde naam als een al geëxtraheerde vermelding uit hetzelfde archief.
De beller heeft niet de vereiste machtiging.
destinationDirectoryName heeft een ongeldige indeling.
Er is geen archiefvermelding gevonden of is beschadigd.
– of –
Een archiefvermelding is gecomprimeerd met behulp van een compressiemethode die niet wordt ondersteund.
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
De map die is opgegeven door destinationDirectoryName kan al bestaan. Met deze methode maakt u de doelmap, de ontbrekende bovenliggende mappen en submappen indien nodig bij het extraheren van vermeldingen. Als het archief leeg is, maakt deze methode de doelmap niet.
Het pad mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Van toepassing op
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 TaskParameters
- source
- ZipArchive
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen. De map kan al bestaan. Ontbrekende mappen worden indien nodig gemaakt bij het extraheren van vermeldingen.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Retouren
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
De map die is opgegeven door destinationDirectoryName kan al bestaan. Met deze methode maakt u de doelmap, de ontbrekende bovenliggende mappen en submappen indien nodig bij het extraheren van vermeldingen. Als het archief leeg is, maakt deze methode de doelmap niet.
Elk uitgepakt bestand heeft hetzelfde relatieve pad als destinationDirectoryName de bronvermelding moet naar de hoofdmap van het archief.
De destinationDirectoryName parameter accepteert relatieve en absolute paden. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als er een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd.
Ingesteld OverwriteFiles op true het overschrijven van bestaande bestanden. De standaardwaarde is false, waardoor extractie een IOException als een bestand dat al wordt geëxtraheerd, wordt veroorzaakt.
Gebruik Password dit om het wachtwoord op te geven voor versleutelde vermeldingen.
EntryNameEncoding wordt niet gebruikt door deze overbelasting. Vermeldingsnamen en opmerkingen worden gedecodeerd met behulp van de codering die is opgegeven wanneer het source archief wordt geopend.
Symbolische koppelingen in het archief worden niet opnieuw gemaakt als symbolische koppelingen. Als destinationDirectoryName of een van de bovenliggende mappen een bestaande koppeling of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie geschreven naar de uiteindelijke doelmap.
Uitzonderingen die optreden tijdens asynchrone extractie worden opgeslagen in de geretourneerde taak en worden gegenereerd wanneer de taak wordt verwacht.
