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
| Name | 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 bestaat mogelijk al. |
| 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.
- 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
De opgegeven map mag niet bestaan. Het pad mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Met deze methode worden alle submappen en de opgegeven map gemaakt, indien nodig.
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 bestaat mogelijk al.
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.
- 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 alle submappen en de opgegeven map gemaakt, indien nodig.
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
De opgegeven map mag niet bestaan. 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
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
