ZipFile.OpenAsync 메서드

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchive> OpenAsync(string archiveFileName, System.IO.Compression.ZipArchiveMode mode, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function OpenAsync (archiveFileName As String, mode As ZipArchiveMode, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchive)

매개 변수

반품

예외

설명

archiveFileName의 경우:

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

mode의 경우:

지정된 경우 Read 파일은 로 System.IO.FileMode.Open열리고 파일이 없으면 throw FileNotFoundException 됩니다.

지정된 경우 Create 파일이 로 System.IO.FileMode.CreateNew열리고 파일이 이미 있는 경우 throw System.IO.IOException 됩니다.

지정한 경우 Update 파일이 .으로 System.IO.FileMode.OpenOrCreate열립니다.

파일이 있고 zip 파일인 경우 해당 항목에 액세스할 수 있고 수정할 수 있으며 새 항목을 만들 수 있습니다.

파일이 있고 zip 파일이 아니면 throw InvalidDataException 됩니다.

파일이 존재하고 비어 있거나 존재하지 않는 경우 새 zip 파일이 만들어집니다.

새 zip 파일을 만들 때 모드로 Create zip 파일을 만드는 것이 더 효율적입니다.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchive> OpenAsync(string archiveFileName, System.IO.Compression.ZipArchiveMode mode, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member OpenAsync : string * System.IO.Compression.ZipArchiveMode * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchive>

Public Shared Function OpenAsync (archiveFileName As String, mode As ZipArchiveMode, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchive)

매개 변수

반품

예외

설명

archiveFileName의 경우:

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

mode의 경우:

지정된 경우 Read 파일은 로 System.IO.FileMode.Open열리고 파일이 없으면 throw FileNotFoundException 됩니다.

지정된 경우 Create 파일이 로 System.IO.FileMode.CreateNew열리고 파일이 이미 있는 경우 throw System.IO.IOException 됩니다.

지정한 경우 Update 파일이 .으로 System.IO.FileMode.OpenOrCreate열립니다.

파일이 있고 zip 파일인 경우 해당 항목에 액세스할 수 있고 수정할 수 있으며 새 항목을 만들 수 있습니다.

파일이 있고 zip 파일이 아니면 throw InvalidDataException 됩니다.

파일이 존재하고 비어 있거나 존재하지 않는 경우 새 zip 파일이 만들어집니다.

새 zip 파일을 만들 때 모드로 Create zip 파일을 만드는 것이 더 효율적입니다.

값 이외의 값을 nullentryNameEncoding 지정하는 것은 권장되지 않습니다. 그러나 항목 이름 또는 주석에 대해 UTF-8 인코딩을 올바르게 지원하지 않는 zip 보관 도구 및 라이브러리와의 상호 운용성을 위해 필요할 수 있습니다.

이 값은 다음과 같이 사용됩니다.

ZIP 보관 파일 읽기(열기):

• 지정되지 않은 경우 entryNameEncoding (== null):
  • 로컬 파일 헤더의 범용 비트 플래그에서 EFS(언어 인코딩 플래그)가 설정 되지 않은 항목의 경우 현재 시스템 기본 코드 페이지(Encoding.Default)를 사용하여 항목 이름과 주석을 디코딩합니다.
  • 로컬 파일 헤더의 범용 비트 플래그에서 EFS(언어 인코딩 플래그)가 설정된 항목의 경우 UTF-8(Encoding.UTF8)을 사용하여 항목 이름과 주석을 디코딩합니다.
• 지정된 경우 entryNameEncoding (!= null):
  • 로컬 파일 헤더의 범용 비트 플래그에 있는 언어 인코딩 플래그(EFS)가 설정 되지 않은 항목의 경우 지정된 entryNameEncoding 항목을 사용하여 항목 이름과 주석을 디코딩합니다.
  • 로컬 파일 헤더의 범용 비트 플래그에서 EFS(언어 인코딩 플래그)가 설정된 항목의 경우 UTF-8(Encoding.UTF8)을 사용하여 항목 이름과 주석을 디코딩합니다.

ZIP 보관 파일 작성(저장):

• 지정되지 않은 경우 entryNameEncoding (== null):
  • ASCII 범위를 벗어난 문자를 포함하는 항목 이름 및 주석의 경우 EFS(언어 인코딩 플래그)는 로컬 파일 헤더의 범용 비트 플래그에 설정되고 UTF-8(Encoding.UTF8)은 항목 이름과 주석을 바이트로 인코딩하는 데 사용됩니다.
  • ASCII 범위를 벗어나는 문자를 포함하지 않는 항목 이름 및 주석의 경우 EFS(언어 인코딩 플래그)는 로컬 파일 헤더의 범용 비트 플래그에 설정되지 않으며 현재 시스템 기본 코드 페이지(Encoding.Default)는 항목 이름과 주석을 바이트로 인코딩하는 데 사용됩니다.
• 지정된 경우 entryNameEncoding (!= null):
  • 지정된 entryNameEncoding 항목은 항상 항목 이름과 주석을 바이트로 인코딩하는 데 사용됩니다.
  • 지정된 entryNameEncoding 항목이 UTF-8 인코딩인 경우에만 로컬 파일 헤더의 범용 비트 플래그에 있는 EFS(언어 인코딩 플래그)가 설정됩니다.

UTF-8 이외의 유니코드 인코딩은 사용할 entryNameEncoding수 없으며, 그렇지 않으면 ArgumentException throw됩니다.