ZipFileExtensions.ExtractToFileAsync 메서드

정의

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

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

중요

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

오버로드

Name	Description
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)	항목의 내용과 지정된 이름을 사용하여 파일 시스템에 파일을 비동기적으로 만듭니다.
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)	항목의 내용과 지정된 이름을 사용하여 파일 시스템에 파일을 비동기적으로 만듭니다.

ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

항목의 내용과 지정된 이름을 사용하여 파일 시스템에 파일을 비동기적으로 만듭니다.

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

source: ZipArchiveEntry

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

destinationFileName: String

항목의 내용을 포함할 파일의 이름입니다.

cancellationToken: CancellationToken

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

반품

Task

예외

UnauthorizedAccessException

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

ArgumentException

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

-또는-

destinationFileName 는 디렉터리를 지정합니다.

ArgumentNullException

destinationFileName은 null입니다.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

I/O 오류가 발생했습니다.

-또는-

이 항목은 현재 쓰기용으로 열려 있습니다.

-또는-

항목이 보관 파일에서 삭제되었습니다.

NotSupportedException

destinationFileName 가 잘못된 형식입니다.

-또는-

이 항목이 속한 ZipArchive가 쓰기 전용 모드로 열렸습니다.

InvalidDataException

항목이 보관 파일에서 누락되었거나 손상되어 읽을 수 없습니다.

-또는-

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

ObjectDisposedException

이 항목이 속한 ZipArchive가 삭제되었습니다.

설명

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

파일의 마지막 쓰기 시간은 항목의 마지막 쓰기 시간으로 설정됩니다. 이 메서드는 동일한 이름의 기존 파일을 덮어쓸 수 없습니다. 명시적 디렉터리(디렉터리 구분 기호 문자로 끝나는 이름의 항목)를 추출하려고 하면 디렉터리가 만들어지지 않습니다.

적용 대상

ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Source:: ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

항목의 내용과 지정된 이름을 사용하여 파일 시스템에 파일을 비동기적으로 만듭니다.

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);

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

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task