TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 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.
De huidige vermelding wordt asynchroon geëxtraheerd naar het bestandssysteem.
public System.Threading.Tasks.Task ExtractToFileAsync(string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);member this.ExtractToFileAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- destinationFileName
- String
Het pad naar het doelbestand.
- overwrite
- Boolean
true als met deze methode een bestaand bestandssysteemobject in het destinationFileName pad moet worden overschreven, false om overschrijven te voorkomen.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone extractiebewerking vertegenwoordigt.
Uitzonderingen
destinationFileName is null.
destinationFileName is leeg.
De bovenliggende map van destinationFileName bestaat niet.
– of –
overwrite is false en er bestaat al een bestand in destinationFileName.
– of –
Er bestaat een map met dezelfde naam als destinationFileName.
– of –
Er is een I/O-probleem opgetreden.
Het invoertype wordt niet ondersteund.
Machtigingen zijn onvoldoende.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Bestanden van het type BlockDevice, CharacterDeviceof Fifo kunnen alleen worden geëxtraheerd op Unix-platforms.
Benodigde bevoegdheden zijn vereist voor het extraheren van een BlockDevice of CharacterDevice naar schijf.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExtractToFile(String, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
