Class SnappyArchive

Class SnappyArchive

Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)

이 클래스는 스내피 아카이브 파일을 나타냅니다. 스내피 아카이브를 구성하거나 추출하는 데 사용합니다.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

상속

objectSnappyArchive

구현

IArchive, IDisposable, IArchiveFileEntry

상속된 멤버

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

생성자

SnappyArchive()

Aspose.Zip.Snappy.SnappyArchive 클래스의 새 인스턴스를 초기화하여 압축을 준비합니다.

public SnappyArchive()

예제

다음 예제는 파일을 압축하는 방법을 보여줍니다.

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snapy");
}

SnappyArchive(Stream)

Aspose.Zip.Snappy.SnappyArchive 클래스의 새 인스턴스를 초기화하여 압축 해제를 준비합니다.

public SnappyArchive(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

비고

이 생성자는 압축 해제를 수행하지 않습니다. 압축 해제를 위한 Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) 메서드를 참조하십시오.

예외

ArgumentException

source는 탐색할 수 없습니다.

ArgumentNullException

source는 null입니다.

SnappyArchive(string)

Aspose.Zip.Snappy.SnappyArchive 클래스의 새 인스턴스를 초기화하여 압축 해제를 준비합니다.

public SnappyArchive(string path)

매개변수

path string

아카이브의 소스 경로입니다.

예제

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

비고

이 생성자는 압축 해제를 수행하지 않습니다. 압축 해제를 위한 Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) 메서드를 참조하십시오.

예외

ArgumentNullException

path는 null입니다.

SecurityException

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

ArgumentException

path가 비어 있거나 공백만 포함하거나 유효하지 않은 문자를 포함하고 있습니다.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

파일을 찾을 수 없습니다.

DirectoryNotFoundException

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

IOException

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

메서드

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

매개변수

disposing bool

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

Extract(Stream)

스내피 아카이브를 스트림으로 추출합니다.

public void Extract(Stream destination)

매개변수

destination Stream

압축 해제된 데이터를 저장할 스트림입니다.

예제

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

예외

InvalidOperationException

아카이브 헤더 및 서비스 정보가 읽히지 않았습니다.

InvalidDataException

헤더 또는 체크섬의 데이터에 오류가 있습니다.

ArgumentNullException

대상 스트림이 null입니다.

ArgumentException

대상 스트림이 쓰기를 지원하지 않습니다.

Extract(FileInfo)

스내피 아카이브를 파일로 추출합니다.

public void Extract(FileInfo fileInfo)

매개변수

fileInfo FileInfo

압축 해제된 데이터를 저장할 FileInfo입니다.

예제

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

예외

InvalidOperationException

아카이브 헤더 및 서비스 정보가 읽히지 않았습니다.

SecurityException

호출자는 fileInfo를 열기 위한 필요한 권한이 없습니다.

ArgumentException

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

FileNotFoundException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo는 null입니다.

DirectoryNotFoundException

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

IOException

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

Extract(string)

스내피 아카이브를 경로에 있는 파일로 추출합니다.

public FileInfo Extract(string path)

매개변수

path string

압축 해제된 데이터를 저장할 파일의 경로입니다.

반환

FileInfo

추출된 데이터를 포함하는 System.IO.FileInfo 인스턴스입니다.

예제

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract("extracted.bin");
    }
}

예외

InvalidOperationException

아카이브 헤더 및 서비스 정보가 읽히지 않았습니다.

ArgumentNullException

path는 null입니다.

SecurityException

호출자는 접근을 위한 필요한 권한이 없습니다.

ArgumentException

path가 비어 있거나 공백만 포함하거나 유효하지 않은 문자를 포함하고 있습니다.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

매개변수

destinationDirectory string

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

비고

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

예외

ArgumentNullException

destinationDirectory는 null입니다.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

Save(Stream)

스내피 아카이브를 제공된 스트림에 저장합니다.

public void Save(Stream output)

매개변수

output Stream

대상 스트림입니다.

예제

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

비고

output는 탐색 가능해야 합니다.

예외

ArgumentException

output는 탐색을 지원하지 않습니다.

ArgumentNullException

output는 null입니다.

Save(FileInfo)

스내피 아카이브를 제공된 대상 파일에 저장합니다.

public void Save(FileInfo destination)

매개변수

destination FileInfo

대상 스트림으로 열릴 FileInfo입니다.

예제

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

예외

SecurityException

호출자는 destination를 열기 위한 필요한 권한이 없습니다.

ArgumentException

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

FileNotFoundException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

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

ArgumentNullException

destination는 null입니다.

DirectoryNotFoundException

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

IOException

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

Save(string)

스내피 아카이브를 제공된 대상 파일에 저장합니다.

public void Save(string destinationFileName)

매개변수

destinationFileName string

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

예제

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

예외

ArgumentNullException

destinationFileName는 null입니다.

SecurityException

호출자는 접근을 위한 필요한 권한이 없습니다.

ArgumentException

destinationFileName가 비어 있거나 공백만 포함하거나 유효하지 않은 문자를 포함하고 있습니다.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

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

public void SetSource(Stream source)

매개변수

source Stream

아카이브의 입력 스트림입니다.

예제

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

예외

ArgumentException

source 스트림은 탐색할 수 없습니다.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

매개변수

fileInfo FileInfo

입력 스트림으로 열릴 FileInfo입니다.

예제

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

예외

SecurityException

호출자는 fileInfo를 열기 위한 필요한 권한이 없습니다.

ArgumentException

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

FileNotFoundException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo는 null입니다.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

매개변수

sourcePath string

입력 스트림으로 열릴 파일의 경로입니다.

예제

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

예외

ArgumentNullException

sourcePath는 null입니다.

SecurityException

호출자는 접근을 위한 필요한 권한이 없습니다.

ArgumentException

sourcePath가 비어 있거나 공백만 포함하거나 유효하지 않은 문자를 포함하고 있습니다.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 한국어