Class ZstandardArchive

path는 null입니다.

호출자는 필요한 권한을 가지고 있지 않습니다.

path는 비어 있거나, 공백만 포함하거나, 잘못된 문자를 포함합니다.

path 파일에 대한 접근이 거부되었습니다.

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

path에 문자열 중간에 콜론(:)이 포함되어 있습니다.

메서드

Dispose()

비관리 리소스를 해제, 릴리스 또는 재설정하는 응용 프로그램 정의 작업을 수행합니다.

public void Dispose()

Dispose(bool)

비관리 리소스를 해제, 릴리스 또는 재설정하는 응용 프로그램 정의 작업을 수행합니다.

protected virtual void Dispose(bool disposing)

매개변수

disposing bool

관리 리소스를 해제해야 하는지 여부.

Extract(Stream)

제공된 스트림으로 아카이브를 추출합니다.

public void Extract(Stream destination)

매개변수

destination Stream

목적지 스트림. 쓰기 가능해야 합니다.

예제

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

예외

destination는 쓰기를 지원하지 않습니다.

Extract(string)

경로로 파일에 아카이브를 추출합니다.

public FileInfo Extract(string path)

매개변수

path string

목적지 파일의 경로. 파일이 이미 존재하면 덮어씌워집니다.

반환

FileInfo

추출된 파일의 정보.

예외

path는 null입니다.

호출자는 필요한 권한을 가지고 있지 않습니다.

path는 비어 있거나, 공백만 포함하거나, 잘못된 문자를 포함합니다.

path 파일에 대한 접근이 거부되었습니다.

path의 파일이 문자열 중간에 콜론(:)을 포함하고 있습니다.

ExtractToDirectory(string)

제공된 디렉터리에 아카이브의 내용을 추출합니다.

public void ExtractToDirectory(string destinationDirectory)

매개변수

destinationDirectory string

추출된 파일을 배치할 디렉터리의 경로.

비고

디렉터리가 존재하지 않으면 생성됩니다.

예외

destinationDirectory는 null입니다.

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

호출자는 기존 디렉터리에 접근할 수 있는 필요한 권한이 없습니다.

디렉터리가 존재하지 않으면 경로에 드라이브 레이블(“C:")의 일부가 아닌 콜론(:) 문자가 포함되어 있습니다.

destinationDirectory는 길이가 0인 문자열이거나, 공백만 포함하거나, 하나 이상의 잘못된 문자를 포함합니다. 잘못된 문자는 System.IO.Path.GetInvalidPathChars 메서드를 사용하여 쿼리할 수 있습니다. -또는- 경로가 접두사가 붙거나, 콜론 문자(:)만 포함합니다.

IOException

지정된 경로가 파일입니다. -또는- 네트워크 이름을 알 수 없습니다.

Open()

추출을 위해 아카이브를 열고 아카이브 내용을 포함하는 스트림을 제공합니다.

public Stream Open()

반환

Stream

아카이브의 내용을 나타내는 스트림.

예제

아카이브를 추출하고 추출된 내용을 파일 스트림으로 복사합니다.

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

.NET 4.0 이상에서는 Stream.CopyTo 메서드를 사용할 수 있습니다: `unpacked.CopyTo(extracted);`

비고

스트림에서 읽어 원래 파일의 내용을 얻습니다. 예제 섹션을 참조하세요.

Save(Stream, ZstandardSaveOptions)

제공된 스트림으로 아카이브를 저장합니다.

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

매개변수

outputStream Stream

목적지 스트림.

settings ZstandardSaveOptions

아카이브 구성을 위한 선택적 설정.

예제

압축된 데이터를 http 응답 스트림에 씁니다.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

비고

outputStream는 쓰기 가능해야 합니다.

예외

InvalidOperationException

outputStream는 쓰기 불가능합니다.

소스가 제공되지 않았습니다.

Save(string, ZstandardSaveOptions)

제공된 목적지 파일에 아카이브를 저장합니다.

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

매개변수

destinationFileName string

생성될 아카이브의 경로. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

settings ZstandardSaveOptions

아카이브 구성을 위한 선택적 설정.

예제

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

예외

destinationFileName는 null입니다.

호출자는 필요한 권한을 가지고 있지 않습니다.

destinationFileName는 비어 있거나, 공백만 포함하거나, 잘못된 문자를 포함합니다.

destinationFileName 파일에 대한 접근이 거부되었습니다.

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

destinationFileName의 파일이 문자열 중간에 콜론(:)을 포함하고 있습니다.

Save(FileInfo, ZstandardSaveOptions)

제공된 목적지 파일에 아카이브를 저장합니다.

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

매개변수

destination FileInfo

목적지 스트림으로 열릴 FileInfo.

settings ZstandardSaveOptions

아카이브 구성을 위한 선택적 설정.

예제

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.zst"));
}

예외

호출자는 destination을 열기 위한 필요한 권한을 가지고 있지 않습니다.

파일 경로가 비어 있거나 공백만 포함합니다.

FileNotFoundException

파일을 찾을 수 없습니다.

파일로의 경로가 읽기 전용이거나 디렉터리입니다.

DirectoryNotFoundException

destination는 null입니다.

지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.

IOException

파일이 이미 열려 있습니다.

SetSource(Stream)

아카이브 내에서 압축할 내용을 설정합니다.

public void SetSource(Stream source)

매개변수

source Stream

아카이브의 입력 스트림.

예제

using (var archive = new ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

SetSource(FileInfo)

아카이브 내에서 압축할 내용을 설정합니다.

public void SetSource(FileInfo fileInfo)

매개변수

fileInfo FileInfo

압축할 파일에 대한 참조.

예제

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.zst");
}

SetSource(string)

아카이브 내에서 압축할 내용을 설정합니다.

public void SetSource(string path)

매개변수

path string

압축할 파일의 경로.

예제

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

예외

path는 null입니다.

호출자는 필요한 권한을 가지고 있지 않습니다.

path는 비어 있거나, 공백만 포함하거나, 잘못된 문자를 포함합니다.

path 파일에 대한 접근이 거부되었습니다.