ZipFileExtensions.CreateEntryFromFileAsync 메서드

정의

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

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

중요

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

오버로드

Name	Description
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)	파일 시스템의 파일을 지정된 항목 이름 아래의 보관 파일에 비동기적으로 추가합니다.
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)	파일 시스템의 파일을 지정된 항목 이름 아래의 보관 파일에 비동기적으로 추가합니다.

CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)

Source:: ZipFileExtensions.ZipArchive.Create.Async.cs

Source:: ZipFileExtensions.ZipArchive.Create.Async.cs

파일 시스템의 파일을 지정된 항목 이름 아래의 보관 파일에 비동기적으로 추가합니다.

public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);

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

<Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)

매개 변수

destination: ZipArchive

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

sourceFileName: String

복사할 파일 시스템의 파일 경로입니다. 경로는 상대 또는 절대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 현재 작업 디렉터리를 기준으로 해석됩니다.

entryName: String

만들 항목의 이름입니다.

cancellationToken: CancellationToken

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

반품

Task<ZipArchiveEntry>

새로 만든 항목에 대한 래퍼입니다.

예외

ArgumentException

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

-또는-

entryName 는 길이가 0인 문자열입니다.

ArgumentNullException

sourceFileName 또는 entryName .입니다 null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

에서 지정 sourceFileName한 파일을 여는 동안 I/O 오류가 발생했습니다.

UnauthorizedAccessException

sourceFileName 디렉터리를 지정했습니다.

-또는-

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

FileNotFoundException

지정한 sourceFileName 파일을 찾을 수 없습니다.

NotSupportedException

sourceFileName 가 잘못된 형식이거나 ZipArchive에서 쓰기를 지원하지 않습니다.

ObjectDisposedException

ZipArchive가 이미 닫혔습니다.

OperationCanceledException

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

설명

보관 파일의 새 항목에는 파일의 내용이 포함됩니다.

보관 항목의 마지막 쓰기 시간은 파일 시스템에서 파일의 마지막 쓰기 시간으로 설정됩니다.

지정된 이름의 항목이 보관에 이미 있는 경우 이름이 동일한 두 번째 항목이 만들어집니다.

지정된 원본 파일에 마지막으로 수정한 시간이 잘못되면 Zip 타임스탬프 형식(1980년 1월 1일 자정)으로 나타낼 수 있는 첫 번째 날짜/시간이 사용됩니다. 지정된 이름의 항목이 보관에 이미 있는 경우 이름이 동일한 두 번째 항목이 만들어집니다. 지정되지 않았 CompressionLevel 으므로 기본 압축 알고리즘의 구현에서 제공하는 기본값이 사용됩니다. 자체 기본값은 ZipArchive 적용하지 않습니다.

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

적용 대상

CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)

Source:: ZipFileExtensions.ZipArchive.Create.Async.cs

Source:: ZipFileExtensions.ZipArchive.Create.Async.cs

파일 시스템의 파일을 지정된 항목 이름 아래의 보관 파일에 비동기적으로 추가합니다.

public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);

static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry>

<Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)