ZipFile.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.
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem.
Overloads
| Name | Description |
|---|---|
| ExtractToDirectoryAsync(String, String, Encoding, Boolean, CancellationToken) |
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem. De opgegeven map mag niet bestaan. Met deze methode worden alle submappen en de opgegeven map gemaakt. 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 heeft naar de destinationDirectoryName als de vermelding naar het archief. Het pad mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als een te archiveren bestand een ongeldige datum/tijd voor het laatst heeft gewijzigd, wordt de eerste datum/tijd in de zip-tijdstempelnotatie (middernacht op 1 januari 1980) gebruikt. |
| ExtractToDirectoryAsync(Stream, String, Encoding, Boolean, CancellationToken) |
Asynchroon haalt alle bestanden uit het zip-archief op dat is opgeslagen in de opgegeven stroom en plaatst deze in de opgegeven doelmap in het bestandssysteem, gebruikt de opgegeven tekencodering voor invoernamen en kunt u eventueel kiezen of de bestanden in de doelmap moeten worden overschreven. |
| ExtractToDirectoryAsync(String, String, Encoding, CancellationToken) |
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem. |
| ExtractToDirectoryAsync(String, String, ZipExtractionOptions, CancellationToken) | |
| ExtractToDirectoryAsync(String, String, Boolean, CancellationToken) |
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem. |
| ExtractToDirectoryAsync(Stream, String, ZipExtractionOptions, CancellationToken) | |
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
Asynchroon extraheert alle bestanden uit het zip-archief dat is opgeslagen in de opgegeven stroom en plaatst deze in de opgegeven doelmap in het bestandssysteem en kunt u eventueel kiezen of de bestanden in de doelmap moeten worden overschreven. |
| ExtractToDirectoryAsync(String, String, CancellationToken) |
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem. |
| ExtractToDirectoryAsync(Stream, String, CancellationToken) |
Alle bestanden uit het zip-archief dat in de opgegeven stroom is opgeslagen, worden asynchroon geëxtraheerd en in de opgegeven doelmap op het bestandssysteem geplaatst. |
| ExtractToDirectoryAsync(Stream, String, Encoding, CancellationToken) |
Asynchroon extrahronisch alle bestanden uit het zip-archief dat is opgeslagen in de opgegeven stroom en plaatst deze in de opgegeven doelmap op het bestandssysteem en gebruikt de opgegeven tekencodering voor invoernamen. |
ExtractToDirectoryAsync(String, String, Encoding, Boolean, CancellationToken)
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem.
De opgegeven map mag niet bestaan. Met deze methode worden alle submappen en de opgegeven map gemaakt.
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 heeft naar de destinationDirectoryName als de vermelding naar het archief. Het pad mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als een te archiveren bestand een ongeldige datum/tijd voor het laatst heeft gewijzigd, wordt de eerste datum/tijd in de zip-tijdstempelnotatie (middernacht op 1 januari 1980) gebruikt.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Text.Encoding * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- sourceArchiveFileName
- String
Het pad naar het archief op het bestandssysteem dat moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- entryNameEncoding
- Encoding
De codering die moet worden gebruikt bij het lezen of schrijven van invoernamen en opmerkingen in deze ZipArchive.
- overwriteFiles
- Boolean
true bestanden te overschrijven; false Anders.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
sourceArchiveFileName of destinationDirectoryName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
sourceArchiveFileName of destinationDirectoryName is null.
sourceArchiveFileName of destinationDirectoryName geeft een pad, bestandsnaam of beide op die groter zijn dan 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 pad dat is opgegeven door sourceArchiveFileName of destinationDirectoryName is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden.
– of –
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 resulteren in een bestandsbestemming die zich buiten de doelmap bevindt (bijvoorbeeld vanwege bovenliggende adreslijsttoegangsors).
– of –
Een archiefvermelding heeft dezelfde naam als een al geëxtraheerde vermelding uit hetzelfde archief.
De beller heeft niet de vereiste machtiging.
sourceArchiveFileName of destinationDirectoryName heeft een ongeldige indeling.
sourceArchiveFileName is niet gevonden.
Het archief dat is opgegeven door sourceArchiveFileName , is geen geldig ZipArchiveren.
– of –
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
Als entryNameEncoding deze is ingesteld op een andere waarde dan null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:
- Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst niet is ingesteld, gebruikt u de opgegeven om
entryNameEncodingde vermeldingsnaam en opmerking te decoderen. - Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst is ingesteld, gebruikt u UTF-8 (
Encoding.UTF8) om de vermeldingsnaam en opmerking te decoderen.
Als entryNameEncoding deze optie is ingesteld null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:
- Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst niet is ingesteld, gebruikt u de huidige standaardcodepagina van het systeem (
Encoding.Default) om de vermeldingsnaam en opmerking te decoderen. - Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst is ingesteld, gebruikt u UTF-8 (
Encoding.UTF8) om de vermeldingsnaam en opmerking te decoderen.
Unicode-coderingen anders dan UTF-8 kunnen niet worden gebruikt voor entryNameEncoding, anders wordt er een ArgumentException gegenereerd.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(Stream, String, Encoding, Boolean, CancellationToken)
- Bron:
- ZipFile.Create.cs
Asynchroon haalt alle bestanden uit het zip-archief op dat is opgeslagen in de opgegeven stroom en plaatst deze in de opgegeven doelmap in het bestandssysteem, gebruikt de opgegeven tekencodering voor invoernamen en kunt u eventueel kiezen of de bestanden in de doelmap moeten worden overschreven.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Text.Encoding * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- Stream
De stroom waaruit het zip-archief moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- entryNameEncoding
- Encoding
De codering die moet worden gebruikt bij het lezen of schrijven van invoernamen en opmerkingen in dit archief. Geef alleen een waarde op voor deze parameter wanneer een codering is vereist voor interoperabiliteit met zip-archiefhulpprogramma's en -bibliotheken die UTF-8-codering niet ondersteunen voor vermeldingsnamen of opmerkingen.
- overwriteFiles
- Boolean
true bestanden te overschrijven; false Anders.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
destinationDirectoryName is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
– of –
entryNameEncoding is ingesteld op een Andere Unicode-codering dan UTF-8.
destinationDirectoryName of source is null.
Het opgegeven pad destinationDirectoryName overschrijdt de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
De naam van een vermelding in het archief is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
– of –
Als u een archiefvermelding ophaalt, wordt er een bestand gemaakt dat zich buiten de map bevindt die is opgegeven door destinationDirectoryName. (Dit kan bijvoorbeeld gebeuren als de vermeldingsnaam bovenliggende adreslijsttoegangsors bevat.)
– of –
overwriteFiles is false en een archiefvermelding die moet worden geëxtraheerd, heeft dezelfde naam als een vermelding die al is geëxtraheerd of die bestaat in destinationDirectoryName.
De aanroeper heeft niet de vereiste machtigingen voor toegang tot het archief of de doelmap.
destinationDirectoryName bevat een ongeldige indeling.
Het archief in de source stream is geen geldig zip-archief.
– of –
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
Met deze methode worden de opgegeven map en alle submappen gemaakt. De doelmap kan niet al bestaan. Uitzonderingen met betrekking tot het valideren van de paden in de destinationDirectoryName of de bestanden in het zip-archief in de source parameters worden gegenereerd vóór extractie. Als er anders een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd. Elk uitgepakt bestand heeft hetzelfde relatieve pad naar de map die is destinationDirectoryName opgegeven als de bronvermelding, moet in de hoofdmap van het archief staan.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(String, String, Encoding, CancellationToken)
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- sourceArchiveFileName
- String
Het pad naar het archief op het bestandssysteem dat moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map in het bestandssysteem. De opgegeven map mag niet bestaan, maar de map waarin deze zich bevindt, moet bestaan.
- entryNameEncoding
- Encoding
De codering die moet worden gebruikt bij het lezen of schrijven van invoernamen en opmerkingen in deze ZipArchive.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
sourceArchiveFileName of destinationDirectoryName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
sourceArchiveFileName of destinationDirectoryName is null.
sourceArchiveFileName of destinationDirectoryName geeft een pad, bestandsnaam of beide op die groter zijn dan 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 pad dat is opgegeven door sourceArchiveFileName of destinationDirectoryName is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden.
– of –
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 resulteren in een bestandsbestemming die zich buiten de doelmap bevindt (bijvoorbeeld vanwege bovenliggende adreslijsttoegangsors).
– of –
Een archiefvermelding heeft dezelfde naam als een al geëxtraheerde vermelding uit hetzelfde archief.
De beller heeft niet de vereiste machtiging.
sourceArchiveFileName of destinationDirectoryName heeft een ongeldige indeling.
sourceArchiveFileName is niet gevonden.
Het archief dat is opgegeven door sourceArchiveFileName , is geen geldig ZipArchiveren.
– of –
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. Met deze methode worden alle submappen en de opgegeven map gemaakt.
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 heeft als destinationDirectoryName de vermelding in het archief. Het pad accepteert relatieve of absolute padinformatie; relatieve paden worden geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Als entryNameEncoding deze is ingesteld op een andere waarde dan null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:
- Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst niet is ingesteld, gebruikt u de opgegeven om
entryNameEncodingde vermeldingsnaam en opmerking te decoderen. - Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst is ingesteld, gebruikt u UTF-8 (
Encoding.UTF8) om de vermeldingsnaam en opmerking te decoderen.
Als entryNameEncoding deze optie is ingesteld null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:
- Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst niet is ingesteld, gebruikt u de huidige standaardcodepagina van het systeem (
Encoding.Default) om de vermeldingsnaam en opmerking te decoderen. - Voor vermeldingen waarin de vlag voor taalcodering (EFS) in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst is ingesteld, gebruikt u UTF-8 (
Encoding.UTF8) om de vermeldingsnaam en opmerking te decoderen.
Unicode-coderingen anders dan UTF-8 kunnen niet worden gebruikt voor entryNameEncoding, anders wordt er een ArgumentException gegenereerd.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(String, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- sourceArchiveFileName
- String
- destinationDirectoryName
- String
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Retouren
Van toepassing op
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- sourceArchiveFileName
- String
Het pad naar het archief op het bestandssysteem dat moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- overwriteFiles
- Boolean
true bestanden te overschrijven; false Anders.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
sourceArchiveFileName of destinationDirectoryName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
sourceArchiveFileName of destinationDirectoryName is null.
sourceArchiveFileName of destinationDirectoryName geeft een pad, bestandsnaam of beide op die groter zijn dan 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 pad dat is opgegeven door sourceArchiveFileName of destinationDirectoryName is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden.
– of –
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 resulteren in een bestandsbestemming die zich buiten de doelmap bevindt (bijvoorbeeld vanwege bovenliggende adreslijsttoegangsors).
– of –
Een archiefvermelding heeft dezelfde naam als een al geëxtraheerde vermelding uit hetzelfde archief.
De beller heeft niet de vereiste machtiging.
sourceArchiveFileName of destinationDirectoryName heeft een ongeldige indeling.
sourceArchiveFileName is niet gevonden.
sourceArchiveFileName geen geldige ZipArchiveren.
– of –
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. Met deze methode worden alle submappen en de opgegeven map gemaakt.
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 heeft als destinationDirectoryName de vermelding in het archief. Het pad accepteert relatieve of absolute padinformatie; relatieve paden worden geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(Stream, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- Stream
- destinationDirectoryName
- String
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Retouren
Van toepassing op
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
Asynchroon extraheert alle bestanden uit het zip-archief dat is opgeslagen in de opgegeven stroom en plaatst deze in de opgegeven doelmap in het bestandssysteem en kunt u eventueel kiezen of de bestanden in de doelmap moeten worden overschreven.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- Stream
De stroom waaruit het zip-archief moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- overwriteFiles
- Boolean
true bestanden te overschrijven; false Anders.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
destinationDirectoryName is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
destinationDirectoryName of source is null.
Het opgegeven pad destinationDirectoryName overschrijdt de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
De naam van een vermelding in het archief is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
– of –
Als u een archiefvermelding ophaalt, wordt er een bestand gemaakt dat zich buiten de map bevindt die is opgegeven door destinationDirectoryName. (Dit kan bijvoorbeeld gebeuren als de vermeldingsnaam bovenliggende adreslijsttoegangsors bevat.)
– of –
overwriteFiles is false en een archiefvermelding die moet worden geëxtraheerd, heeft dezelfde naam als een vermelding die al is geëxtraheerd of die bestaat in destinationDirectoryName.
De aanroeper heeft niet de vereiste machtigingen voor toegang tot het archief of de doelmap.
destinationDirectoryName bevat een ongeldige indeling.
Het archief in de source stream is geen geldig zip-archief.
– of –
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
Met deze methode worden de opgegeven map en alle submappen gemaakt. De doelmap kan niet al bestaan. Uitzonderingen met betrekking tot het valideren van de paden in de destinationDirectoryName of de bestanden in het zip-archief in de source parameters worden gegenereerd vóór extractie. Als er anders een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd. Elk uitgepakt bestand heeft hetzelfde relatieve pad naar de map die is destinationDirectoryName opgegeven als de bronvermelding, moet in de hoofdmap van het archief staan.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(String, String, CancellationToken)
Alle bestanden in het opgegeven archief worden asynchroon geëxtraheerd naar een map in het bestandssysteem.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- sourceArchiveFileName
- String
Het pad naar het archief op het bestandssysteem dat moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
sourceArchiveFileName of destinationDirectoryName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
sourceArchiveFileName of destinationDirectoryName is null.
sourceArchiveFileName of destinationDirectoryName geeft een pad, bestandsnaam of beide op die groter zijn dan 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 pad dat is opgegeven door sourceArchiveFileName of destinationDirectoryName is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden.
– of –
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 resulteren in een bestandsbestemming die zich buiten de doelmap bevindt (bijvoorbeeld vanwege bovenliggende adreslijsttoegangsors).
– of –
Een archiefvermelding heeft dezelfde naam als een al geëxtraheerde vermelding uit hetzelfde archief.
De beller heeft niet de vereiste machtiging.
sourceArchiveFileName of destinationDirectoryName heeft een ongeldige indeling.
sourceArchiveFileName is niet gevonden.
Het archief dat is opgegeven door sourceArchiveFileName , is geen geldig ZipArchiveren.
– of –
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. Met deze methode worden alle submappen en de opgegeven map gemaakt.
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 heeft als destinationDirectoryName de vermelding in het archief. Het pad accepteert relatieve of absolute padinformatie; relatieve paden worden geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(Stream, String, CancellationToken)
Alle bestanden uit het zip-archief dat in de opgegeven stroom is opgeslagen, worden asynchroon geëxtraheerd en in de opgegeven doelmap op het bestandssysteem geplaatst.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- Stream
De stroom waaruit het zip-archief moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
destinationDirectoryName is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
destinationDirectoryName of source is null.
Het opgegeven pad destinationDirectoryName overschrijdt de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
De naam van een vermelding in het archief is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
– of –
Als u een archiefvermelding ophaalt, wordt er een bestand gemaakt dat zich buiten de map bevindt die is opgegeven door destinationDirectoryName. (Dit kan bijvoorbeeld gebeuren als de vermeldingsnaam bovenliggende adreslijsttoegangsors bevat.)
– of –
Een archiefvermelding die moet worden geëxtraheerd, heeft dezelfde naam als een vermelding die al is geëxtraheerd of die bestaat in destinationDirectoryName.
De aanroeper heeft niet de vereiste machtigingen voor toegang tot het archief of de doelmap.
destinationDirectoryName bevat een ongeldige indeling.
Het archief in de source stream is geen geldig zip-archief.
– of –
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
Met deze methode worden de opgegeven map en alle submappen gemaakt. De doelmap kan niet al bestaan. Uitzonderingen met betrekking tot het valideren van de paden in de destinationDirectoryName of de bestanden in het zip-archief in de source parameters worden gegenereerd vóór extractie. Als er anders een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd. Elk uitgepakt bestand heeft hetzelfde relatieve pad naar de map die is destinationDirectoryName opgegeven als de bronvermelding, moet in de hoofdmap van het archief staan.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
Van toepassing op
ExtractToDirectoryAsync(Stream, String, Encoding, CancellationToken)
Asynchroon extrahronisch alle bestanden uit het zip-archief dat is opgeslagen in de opgegeven stroom en plaatst deze in de opgegeven doelmap op het bestandssysteem en gebruikt de opgegeven tekencodering voor invoernamen.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- Stream
De stroom waaruit het zip-archief moet worden geëxtraheerd.
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen, opgegeven als een relatief of absoluut pad. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
- entryNameEncoding
- Encoding
De codering die moet worden gebruikt bij het lezen of schrijven van invoernamen en opmerkingen in dit archief. Geef alleen een waarde op voor deze parameter wanneer een codering is vereist voor interoperabiliteit met zip-archiefhulpprogramma's en -bibliotheken die UTF-8-codering niet ondersteunen voor vermeldingsnamen of opmerkingen.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
destinationDirectoryName is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
– of –
entryNameEncoding is ingesteld op een Andere Unicode-codering dan UTF-8.
destinationDirectoryName of source is null.
Het opgegeven pad destinationDirectoryName overschrijdt de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
De naam van een vermelding in het archief is Empty, bevat slechts witruimte of bevat ten minste één ongeldig teken.
– of –
Als u een archiefvermelding ophaalt, wordt er een bestand gemaakt dat zich buiten de map bevindt die is opgegeven door destinationDirectoryName. (Dit kan bijvoorbeeld gebeuren als de vermeldingsnaam bovenliggende adreslijsttoegangsors bevat.)
– of –
Een archiefvermelding die moet worden geëxtraheerd, heeft dezelfde naam als een vermelding die al is geëxtraheerd of die bestaat in destinationDirectoryName.
De aanroeper heeft niet de vereiste machtigingen voor toegang tot het archief of de doelmap.
destinationDirectoryName bevat een ongeldige indeling.
Het archief in de source stream is geen geldig zip-archief.
– of –
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
Met deze methode worden de opgegeven map en alle submappen gemaakt. De doelmap kan niet al bestaan. Uitzonderingen met betrekking tot het valideren van de paden in de destinationDirectoryName of de bestanden in het zip-archief in de source parameters worden gegenereerd vóór extractie. Als er anders een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd. Elk uitgepakt bestand heeft hetzelfde relatieve pad naar de map die is destinationDirectoryName opgegeven als de bronvermelding, moet in de hoofdmap van het archief staan.
Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.
Warning
Deze methode beperkt niet de totale niet-gecomprimeerde grootte of het aantal items dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van ZipArchiveen controleren of de totale niet-gecomprimeerde grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.
