ZipFileExtensions.ExtractToFileAsync 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.
Asynchroon maakt u een bestand op het bestandssysteem met de inhoud van het item en de opgegeven naam.
Overloads
| Name | Description |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Asynchroon maakt u een bestand op het bestandssysteem met de inhoud van het item en de opgegeven naam. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Asynchroon maakt u een bestand op het bestandssysteem met de inhoud van het item en de opgegeven naam. |
| ExtractToFileAsync(ZipArchiveEntry, String, ZipExtractionOptions, CancellationToken) |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
Asynchroon maakt u een bestand op het bestandssysteem met de inhoud van het item en de opgegeven naam.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- ZipArchiveEntry
De zip-archiefvermelding waaruit een bestand moet worden geëxtraheerd.
- destinationFileName
- String
De naam van het bestand dat de inhoud van de vermelding bevat.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
De beller heeft niet de vereiste machtiging.
destinationFileName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
– of –
destinationFileName hiermee geeft u een map.
destinationFileName 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 destinationFileName pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden.
– of –
De vermelding is momenteel geopend voor schrijven.
– of –
De vermelding is verwijderd uit het archief.
destinationFileName heeft een ongeldige indeling.
– of –
De ZipArchive waartoe deze vermelding behoort, is geopend in een modus voor alleen-schrijven.
De vermelding ontbreekt in het archief of is beschadigd en kan niet worden gelezen.
– of –
De vermelding is gecomprimeerd met behulp van een compressiemethode die niet wordt ondersteund.
De ZipArchive waartoe deze vermelding behoort, is verwijderd.
Opmerkingen
Het opgegeven pad is toegestaan om relatieve of absolute padgegevens op te geven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
De laatste schrijftijd van het bestand is ingesteld op de laatste schrijftijd van het item. Deze methode staat het overschrijven van een bestaand bestand met dezelfde naam niet toe. Als u expliciete mappen probeert te extraheren (vermeldingen met namen die eindigen op adreslijstscheidingstekens), leidt dit niet tot het maken van een map.
Van toepassing op
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
Asynchroon maakt u een bestand op het bestandssysteem met de inhoud van het item en de opgegeven naam.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- ZipArchiveEntry
De zip-archiefvermelding waaruit een bestand moet worden geëxtraheerd.
- destinationFileName
- String
De naam van het bestand dat de inhoud van de vermelding bevat.
- overwrite
- Boolean
true bestanden te overschrijven; false Anders.
- cancellationToken
- CancellationToken
Het annuleringstoken dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Uitzonderingen
De beller heeft niet de vereiste machtiging.
destinationFileName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door InvalidPathChars.
– of –
destinationFileName hiermee geeft u een map.
destinationFileName 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 destinationFileName pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Er is een I/O-fout opgetreden.
– of –
De vermelding is momenteel geopend voor schrijven.
– of –
De vermelding is verwijderd uit het archief.
destinationFileName heeft een ongeldige indeling.
– of –
De ZipArchive waartoe deze vermelding behoort, is geopend in een modus voor alleen-schrijven.
De vermelding ontbreekt in het archief of is beschadigd en kan niet worden gelezen.
– of –
De vermelding is gecomprimeerd met behulp van een compressiemethode die niet wordt ondersteund.
De ZipArchive waartoe deze vermelding behoort, is verwijderd.
Een asynchrone bewerking wordt geannuleerd.
Opmerkingen
Het opgegeven pad is toegestaan om relatieve of absolute padgegevens op te geven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
De laatste schrijftijd van het bestand is ingesteld op de laatste schrijftijd van het item.
Met deze methode kan een bestaand bestand met dezelfde naam worden overschreven.
Van toepassing op
ExtractToFileAsync(ZipArchiveEntry, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- source
- ZipArchiveEntry
- destinationFileName
- String
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
