TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Extraherar asynkront den aktuella posten till filsystemet.
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 TaskParametrar
- destinationFileName
- String
Sökvägen till målfilen.
- overwrite
- Boolean
true om den här metoden ska skriva över ett befintligt filsystemobjekt som finns i destinationFileName sökvägen, false för att förhindra överskrivning.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona extraheringsåtgärden.
Undantag
destinationFileName är null.
destinationFileName är tom.
Den överordnade katalogen destinationFileName för finns inte.
-eller-
overwrite är false och en fil finns redan i destinationFileName.
-eller-
Det finns en katalog med samma namn som destinationFileName.
-eller-
Ett I/O-problem uppstod.
Posttypen stöds inte.
Behörigheterna är otillräckliga.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Filer av typen BlockDevice, CharacterDeviceeller Fifo kan bara extraheras i Unix-plattformar.
Utökade privilegier krävs för att extrahera en BlockDevice eller CharacterDevice till disk.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ExtractToFile(String, Boolean).
