Class LzipArchive

Class LzipArchive

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

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

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

상속

objectLzipArchive

구현

IArchive, IDisposable, IArchiveFileEntry

상속된 멤버

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

생성자

LzipArchive(LzipArchiveSettings)

Aspose.Zip.Lzip.LzipArchive의 새 인스턴스를 초기화합니다.

public LzipArchive(LzipArchiveSettings settings = null)

매개변수

settings LzipArchiveSettings

사전 크기를 정의하는 특정 lzip 아카이브의 설정입니다.

LzipArchive(Stream)

압축 해제를 위해 준비된 Aspose.Zip.Lzip.LzipArchive 클래스의 새 인스턴스를 초기화합니다.

public LzipArchive(Stream sourceStream)

매개변수

sourceStream Stream

아카이브의 소스입니다.

비고

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

예외

ArgumentException

sourceStream은(는) 탐색할 수 없습니다.

ArgumentNullException

sourceStream은(는) null입니다.

InvalidDataException

헤더가 lzip 아카이브 유형과 일치하지 않습니다.

LzipArchive(string)

압축 해제를 위해 준비된 Aspose.Zip.Lzip.LzipArchive 클래스의 새 인스턴스를 초기화합니다.

public LzipArchive(string path)

매개변수

path string

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

예제

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

비고

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

예외

ArgumentNullException

path은(는) null입니다.

SecurityException

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

ArgumentException

path이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.

UnauthorizedAccessException

파일 path에 대한 액세스가 거부되었습니다.

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

파일을 찾을 수 없습니다.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

헤더가 lzip 아카이브 유형과 일치하지 않습니다.

속성

Settings

특정 lzip 아카이브의 설정을 가져옵니다.

public LzipArchiveSettings Settings { get; }

속성 값

LzipArchiveSettings

메서드

Dispose()

관리되지 않는 리소스를 해제, 해방 또는 재설정하는 애플리케이션 정의 작업을 수행합니다.

public void Dispose()

Dispose(bool)

관리되지 않는 리소스를 해제, 해방 또는 재설정하는 애플리케이션 정의 작업을 수행합니다.

protected virtual void Dispose(bool disposing)

매개변수

disposing bool

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

Extract(Stream)

lzip 아카이브를 스트림에 추출합니다.

public void Extract(Stream destination)

매개변수

destination Stream

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

예제

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

예외

InvalidOperationException

아카이브 헤더 및 서비스 정보를 읽지 못했습니다.

InvalidDataException

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

ArgumentNullException

대상 스트림이 null입니다.

ArgumentException

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

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

매개변수

fileInfo FileInfo

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

예제

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

예외

InvalidOperationException

아카이브 헤더 및 서비스 정보를 읽지 못했습니다.

SecurityException

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

ArgumentException

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

FileNotFoundException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo은(는) null입니다.

DirectoryNotFoundException

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

IOException

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

Extract(string)

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

public void Extract(string path)

매개변수

path string

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

예제

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(xzFile))
    {
        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)

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

public void Save(Stream outputStream)

매개변수

outputStream Stream

대상 스트림입니다.

예제

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

비고

outputStream은(는) 탐색할 수 있어야 합니다.

예외

ArgumentException

outputStream은(는) 탐색을 지원하지 않습니다.

ArgumentNullException

outputStream은(는) null입니다.

Save(string)

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

public void Save(string destinationFileName)

매개변수

destinationFileName string

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

예제

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

예외

ArgumentNullException

destinationFileName은(는) null입니다.

SecurityException

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

ArgumentException

destinationFileName이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.

UnauthorizedAccessException

파일 destinationFileName에 대한 액세스가 거부되었습니다.

PathTooLongException

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

NotSupportedException

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

Save(FileInfo)

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

public void Save(FileInfo destination)

매개변수

destination FileInfo

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

예제

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

예외

SecurityException

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

ArgumentException

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

FileNotFoundException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

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

ArgumentNullException

destination은(는) null입니다.

DirectoryNotFoundException

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

IOException

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

SetSource(Stream)

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

public void SetSource(Stream source)

매개변수

source Stream

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

예제

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

예외

ArgumentException

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

매개변수

fileInfo FileInfo

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

예제

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

예외

SecurityException

호출자가 fileInfo을(를) 열기 위한 필요한 권한을 가지고 있지 않습니다.

ArgumentException

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

FileNotFoundException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo은(는) null입니다.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string path)

매개변수

path string

압축할 파일의 경로입니다.

예제

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

예외

ArgumentNullException

path은(는) null입니다.

SecurityException

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

ArgumentException

path이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.

UnauthorizedAccessException

파일 path에 대한 액세스가 거부되었습니다.

PathTooLongException

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

NotSupportedException

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

 한국어