TarFile.ExtractToDirectoryAsync 메서드

정의

네임스페이스:

System.Formats.Tar

어셈블리:

System.Formats.Tar.dll

오버로드

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	tar 보관 파일을 나타내는 스트림의 내용을 지정된 디렉터리에 비동기적으로 추출합니다.
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	tar 파일의 내용을 지정된 디렉터리에 비동기적으로 추출합니다.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Source:

TarFile.cs

tar 보관 파일을 나타내는 스트림의 내용을 지정된 디렉터리에 비동기적으로 추출합니다.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

source

Stream

tar 보관 파일이 포함된 스트림입니다.

destinationDirectoryName

String

파일 시스템 항목을 추출해야 하는 대상 디렉터리의 경로입니다.

overwriteFiles

Boolean

true 에서 파일 및 디렉터리를 destinationDirectoryName덮어쓰려면 이 false 고, 덮어쓰지 않도록 하고, 기존 이름으로 파일 또는 디렉터리를 찾을 수 있으면 throw합니다.

cancellationToken

CancellationToken

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

반환

Task

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

예외

ArgumentNullException

source 또는 destinationDirectoryName가 null인 경우

DirectoryNotFoundException

destinationDirectoryName 디렉터리 경로를 찾을 수 없습니다.

UnauthorizedAccessException

사용 권한이 부족합니다.

ArgumentException

tar 항목 중 하나를 추출하면 지정된 대상 디렉터리 외부에 파일이 생성됩니다.

또는

destinationDirectoryName가 비어 있는 경우

또는

source 이 읽기를 지원하지 않습니다.

IOException

I/O 예외가 발생했습니다.

OperationCanceledException

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

설명

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

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

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

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Source:

TarFile.cs

tar 파일의 내용을 지정된 디렉터리에 비동기적으로 추출합니다.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

sourceFileName

String

추출할 tar 파일의 경로입니다.

destinationDirectoryName

String

파일 시스템 항목을 추출해야 하는 대상 디렉터리의 경로입니다.

overwriteFiles

Boolean

true 에서 파일 및 디렉터리를 destinationDirectoryName덮어쓰려면 이 false 고, 덮어쓰지 않도록 하고, 기존 이름으로 파일 또는 디렉터리를 찾을 수 있으면 throw합니다.

cancellationToken

CancellationToken

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

반환

Task

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

예외

ArgumentNullException

sourceFileName 또는 destinationDirectoryName가 null인 경우

DirectoryNotFoundException

destinationDirectoryName 디렉터리 경로를 찾을 수 없습니다.

FileNotFoundException

sourceFileName 파일 경로를 찾을 수 없습니다.

UnauthorizedAccessException

사용 권한이 부족합니다.

ArgumentException

tar 항목 중 하나를 추출하면 지정된 대상 디렉터리 외부에 파일이 생성됩니다.

또는

sourceFileName 또는 destinationDirectoryName 비어 있습니다.

IOException

I/O 예외가 발생했습니다.

OperationCanceledException

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

설명

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

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

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