다음을 통해 공유


TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 메서드

정의

파일 시스템에 대한 현재 항목을 비동기적으로 추출합니다.

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.Task
Public Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

destinationFileName
String

대상 파일의 경로입니다.

overwrite
Boolean

true 이 메서드가 경로에 destinationFileName 있는 기존 파일 시스템 개체를 덮어써야 하면 이고, false 덮어쓰지 않도록 합니다.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반환

비동기 추출 작업을 나타내는 작업입니다.

예외

destinationFileName이(가) null인 경우

destinationFileName가 비어 있는 경우

destinationFileName 부모 디렉터리가 없습니다.

또는

overwritefalse 이고 파일이 에 이미 있습니다 destinationFileName.

또는

디렉터리가 와 같은 이름으로 destinationFileName존재합니다.

또는

I/O 문제가 발생했습니다.

항목 유형이 지원되지 않습니다.

사용 권한이 부족합니다.

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

, CharacterDevice또는 Fifo 형식BlockDevice의 파일은 Unix 플랫폼에서만 추출할 수 있습니다.

또는 CharacterDevice 를 디스크에 추출하려면 권한 상승이 BlockDevice 필요합니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw ExtractToFile(String, Boolean)된 예외를 참조하세요.

적용 대상