ZipFileExtensions.ExtractToDirectoryAsync 메서드

정의

네임스페이스:: System.IO.Compression

어셈블리:: netstandard.dll, System.IO.Compression.ZipFile.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

Name	Description
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)	보관에 있는 모든 파일을 파일 시스템의 디렉터리에 비동기적으로 추출합니다. 지정된 디렉터리가 이미 있을 수 있습니다.
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)	보관 파일의 모든 파일을 파일 시스템의 디렉터리로 추출합니다. 지정된 디렉터리가 이미 있을 수 있습니다.

ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)

Source:: ZipFileExtensions.ZipArchive.Extract.Async.cs

Source:: ZipFileExtensions.ZipArchive.Extract.Async.cs

보관에 있는 모든 파일을 파일 시스템의 디렉터리에 비동기적으로 추출합니다. 지정된 디렉터리가 이미 있을 수 있습니다.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

source: ZipArchive

파일을 추출할 zip 보관 파일입니다.

destinationDirectoryName: String

파일 시스템의 디렉터리에 대한 경로입니다.

cancellationToken: CancellationToken

취소 요청을 모니터링할 취소 토큰입니다.

반품

Task

예외

ArgumentException

destinationDirectoryName 는 길이가 0인 문자열이거나, 공백만 포함하거나, InvalidPathChars에 정의된 하나 이상의 잘못된 문자를 포함합니다.

ArgumentNullException

destinationDirectoryName은 null입니다.

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다 시스템 정의 최대 길이를 초과합니다. 예를 들어 Windows 기반 플랫폼에서 경로는 248자 미만이어야 하고 파일 이름은 260자 미만이어야 합니다.

DirectoryNotFoundException

지정한 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있는 경우).

IOException

보관 항목의 이름은 길이가 0이거나, 공백만 포함하거나, InvalidPathChars에서 정의한 대로 하나 이상의 잘못된 문자를 포함합니다.

-또는-

보관 항목을 추출하면 외부에 있는 대상 파일이 destinationDirectoryName 생성됩니다(예: 항목 이름에 부모 디렉터리 접근자가 포함된 경우).

-또는-

보관 항목의 이름은 동일한 보관 파일에서 이미 추출된 항목과 같습니다.

UnauthorizedAccessException

호출자에게 필요한 권한이 없습니다.

NotSupportedException

destinationDirectoryName 가 잘못된 형식입니다.

InvalidDataException

보관 항목을 찾을 수 없거나 손상되었습니다.

-또는-

보관 항목은 지원되지 않는 압축 방법을 사용하여 압축되었습니다.

OperationCanceledException

비동기 작업이 취소됩니다.

설명

지정된 디렉터리가 없어야 합니다. 경로는 상대 또는 절대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 현재 작업 디렉터리를 기준으로 해석됩니다.

이 메서드는 필요한 경우 모든 하위 디렉터리와 지정된 디렉터리를 만듭니다.

보관 파일을 추출하는 동안 오류가 발생하면 보관 파일은 부분적으로 추출된 상태로 유지됩니다.

추출된 파일이 보관 파일의 루트에 있는 항목과 동일한 상대 경로를 destinationDirectoryName 가지도록 각 항목이 추출됩니다. 보관할 파일에 마지막으로 수정한 시간이 잘못되면 Zip 타임스탬프 형식(1980년 1월 1일 자정)으로 나타낼 수 있는 첫 번째 날짜/시간이 사용됩니다.

적용 대상

ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)

Source:: ZipFileExtensions.ZipArchive.Create.cs

Source:: ZipFileExtensions.ZipArchive.Extract.Async.cs

보관 파일의 모든 파일을 파일 시스템의 디렉터리로 추출합니다. 지정된 디렉터리가 이미 있을 수 있습니다.

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

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

<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task