ZipFile.CreateFromDirectoryAsync 메서드

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

반품

예외

설명

파일 시스템의 디렉터리 구조는 보관 파일에 유지됩니다. 디렉터리가 비어 있으면 빈 보관이 만들어집니다.

이 메서드 오버로드는 보관에 기본 디렉터리를 포함하지 않으며 압축 수준을 지정할 수 없습니다.

기본 디렉터리를 포함하거나 압축 수준을 지정하려면 메서드 오버로드를 CreateFromDirectory(String, Stream, CompressionLevel, Boolean) 호출합니다.

디렉터리의 파일을 보관 파일에 추가할 수 없는 경우 보관 파일은 불완전하고 유효하지 않은 상태로 남아 있으며 메서드는 예외를 IOException throw합니다.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

반품

예외

설명

디렉터리 구조는 보관에 유지되며 파일을 보관할 재귀 검색이 수행됩니다. 보관 파일이 없어야 합니다. 디렉터리가 비어 있으면 빈 보관이 만들어집니다. 디렉터리의 파일을 보관 파일에 추가할 수 없는 경우 보관 파일은 불완전하고 유효하지 않은 상태로 남게 되며 메서드는 예외를 throw합니다. 이 메서드는 보관에 기본 디렉터리를 포함하지 않습니다.

보관 파일에 파일을 추가하는 동안 오류가 발생하면 이 메서드는 파일 추가를 중지하고 보관 파일을 잘못된 상태로 둡니다. 경로는 상대 또는 절대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 현재 작업 디렉터리를 기준으로 해석됩니다. 보관 파일에 유효한 zip 타임스탬프가 아닌 마지막 쓰기 시간 필드의 데이터가 있는 경우 1980년 1월 1일 자정의 표시기 값이 파일의 마지막 수정 시간에 사용됩니다. 지정된 이름의 항목이 보관에 이미 있는 경우 이름이 동일한 두 번째 항목이 만들어집니다. 지정되지 않았 CompressionLevel 으므로 기본 압축 알고리즘의 구현에서 제공하는 기본값이 사용되며 자체 기본값을 ZipArchive 적용하지 않습니다.

(현재 기본 압축 알고리즘은 클래스에서 DeflateStream 제공됩니다.)

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

반품

예외

설명

파일 시스템의 디렉터리 구조는 보관 파일에 유지됩니다. 디렉터리가 비어 있으면 빈 보관이 만들어집니다.

이 메서드 오버로드를 사용하여 압축 수준 및 보관에 기본 디렉터리를 포함할지 여부를 지정합니다.

디렉터리의 파일을 보관 파일에 추가할 수 없는 경우 보관 파일은 불완전하고 유효하지 않은 상태로 남아 있으며 메서드는 예외를 IOException throw합니다.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

반품

예외

설명

디렉터리 구조는 보관에 유지되며 파일을 보관할 재귀 검색이 수행됩니다. 보관 파일이 없어야 합니다. 디렉터리가 비어 있으면 빈 보관이 만들어집니다.

디렉터리의 파일을 보관 파일에 추가할 수 없는 경우 보관 파일은 불완전하고 유효하지 않은 상태로 남게 되며 메서드는 예외를 throw합니다. 이 메서드는 필요에 따라 보관에 기본 디렉터리를 포함합니다.

보관 파일에 파일을 추가하는 동안 오류가 발생하면 이 메서드는 파일 추가를 중지하고 보관 파일을 잘못된 상태로 둡니다. 경로는 상대 또는 절대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 현재 작업 디렉터리를 기준으로 해석됩니다. 보관 파일에 유효한 zip 타임스탬프가 아닌 마지막 쓰기 시간 필드의 데이터가 있는 경우 1980년 1월 1일 자정의 표시기 값이 파일의 마지막 수정 시간에 사용됩니다. 지정된 이름의 항목이 보관에 이미 있는 경우 이름이 동일한 두 번째 항목이 만들어집니다. 지정되지 않았 CompressionLevel 으므로 기본 압축 알고리즘의 구현에서 제공하는 기본값이 사용됩니다. 자체 기본값은 ZipArchive 적용하지 않습니다.

(현재 기본 압축 알고리즘은 클래스에서 DeflateStream 제공됩니다.)

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

반품

예외

설명

파일 시스템의 디렉터리 구조는 보관 파일에 유지됩니다. 디렉터리가 비어 있으면 빈 보관이 만들어집니다.

이 메서드 오버로드를 사용하여 압축 수준 및 문자 인코딩을 지정하고 보관에 기본 디렉터리를 포함할지 여부를 지정합니다.

디렉터리의 파일을 보관 파일에 추가할 수 없는 경우 보관 파일은 불완전하고 유효하지 않은 상태로 남아 있으며 메서드는 예외를 IOException throw합니다.

Source:

ZipFile.Create.Async.cs

Source:

ZipFile.Create.Async.cs

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * string * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

반품

예외

설명

디렉터리 구조는 보관에 유지되며 파일을 보관할 재귀 검색이 수행됩니다. 보관 파일이 없어야 합니다. 디렉터리가 비어 있으면 빈 보관이 만들어집니다.

디렉터리의 파일을 보관 파일에 추가할 수 없는 경우 보관 파일은 불완전하고 유효하지 않은 상태로 남게 되며 메서드는 예외를 throw합니다. 이 메서드는 필요에 따라 보관에 기본 디렉터리를 포함합니다.

보관 파일에 파일을 추가하는 동안 오류가 발생하면 이 메서드는 파일 추가를 중지하고 보관 파일을 잘못된 상태로 둡니다. 경로는 상대 또는 절대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 현재 작업 디렉터리를 기준으로 해석됩니다. 보관 파일에 유효한 zip 타임스탬프가 아닌 마지막 쓰기 시간 필드의 데이터가 있는 경우 1980년 1월 1일 자정의 표시기 값이 파일의 마지막 수정 시간에 사용됩니다. 지정된 이름의 항목이 보관에 이미 있는 경우 이름이 동일한 두 번째 항목이 만들어집니다. 지정되지 않았 CompressionLevel 으므로 기본 압축 알고리즘의 구현에서 제공하는 기본값이 사용됩니다. 자체 기본값은 ZipArchive 적용하지 않습니다.

(현재 기본 압축 알고리즘은 클래스에서 DeflateStream 제공됩니다.)

이외의 null 값을 entryNameEncoding 지정하는 것은 권장되지 않습니다.

그러나 항목 이름 또는 주석에 대해 UTF-8 인코딩을 올바르게 지원하지 않는 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됩니다.