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

정의

네임스페이스:

System.Formats.Tar

어셈블리:

System.Formats.Tar.dll

Source:

TarEntry.cs

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

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입니다.

반환

Task

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

예외

ArgumentNullException

destinationFileName이(가) null인 경우

ArgumentException

destinationFileName가 비어 있는 경우

IOException

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

또는

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

또는

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

또는

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

InvalidOperationException

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

UnauthorizedAccessException

사용 권한이 부족합니다.

OperationCanceledException

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

설명

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

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

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