Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
이 클래스는 Lzip 아카이브 파일을 나타냅니다. Lzip 아카이브를 구성하거나 추출하는 데 사용합니다.
public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry
상속
구현
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) 메서드를 참조하십시오.
예외
sourceStream
은(는) 탐색할 수 없습니다.
sourceStream
은(는) null입니다.
헤더가 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) 메서드를 참조하십시오.
예외
path
은(는) null입니다.
호출자가 필요한 권한을 가지고 있지 않습니다.
path
이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.
파일 path
에 대한 액세스가 거부되었습니다.
지정된 path
, 파일 이름 또는 둘 다 시스템에서 정의한 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
path
에 문자열 중간에 콜론(:)이 포함되어 있습니다.
파일을 찾을 수 없습니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
헤더가 lzip 아카이브 유형과 일치하지 않습니다.
속성
Settings
특정 lzip 아카이브의 설정을 가져옵니다.
public LzipArchiveSettings Settings { get; }
속성 값
메서드
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);
}
}
}
예외
아카이브 헤더 및 서비스 정보를 읽지 못했습니다.
헤더 또는 체크섬의 데이터에 오류가 있습니다.
대상 스트림이 null입니다.
대상 스트림이 쓰기를 지원하지 않습니다.
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"));
}
}
예외
아카이브 헤더 및 서비스 정보를 읽지 못했습니다.
호출자가 fileInfo
를 열기 위한 필요한 권한을 가지고 있지 않습니다.
파일 경로가 비어 있거나 공백만 포함합니다.
파일을 찾을 수 없습니다.
파일 경로가 읽기 전용이거나 디렉터리입니다.
fileInfo
은(는) null입니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
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");
}
}
예외
아카이브 헤더 및 서비스 정보를 읽지 못했습니다.
path
은(는) null입니다.
호출자가 필요한 권한을 가지고 있지 않습니다.
path
이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.
파일 path
에 대한 액세스가 거부되었습니다.
지정된 path
, 파일 이름 또는 둘 다 시스템에서 정의한 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
path
에 문자열 중간에 콜론(:)이 포함되어 있습니다.
ExtractToDirectory(string)
아카이브의 내용을 제공된 디렉터리에 추출합니다.
public void ExtractToDirectory(string destinationDirectory)
매개변수
destinationDirectory
string
추출된 파일을 배치할 디렉터리에 대한 경로입니다.
비고
디렉터리가 존재하지 않으면 생성됩니다.
예외
destinationDirectory
은(는) null입니다.
지정된 경로, 파일 이름 또는 둘 다 시스템에서 정의한 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
호출자가 기존 디렉터리에 접근하기 위한 필요한 권한을 가지고 있지 않습니다.
디렉터리가 존재하지 않을 경우 경로에 드라이브 레이블(“C:")의 일부가 아닌 콜론 문자(:)가 포함되어 있습니다.
destinationDirectory
가 길이가 0인 문자열이거나, 공백만 포함하거나, 하나 이상의 잘못된 문자가 포함되어 있습니다. 잘못된 문자는 System.IO.Path.GetInvalidPathChars 메서드를 사용하여 조회할 수 있습니다.
- 또는 - 경로가 접두사가 붙거나, 콜론 문자(:)만 포함되어 있습니다.
지정된 경로가 파일입니다. - 또는 - 네트워크 이름을 알 수 없습니다.
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
은(는) 탐색할 수 있어야 합니다.
예외
outputStream
은(는) 탐색을 지원하지 않습니다.
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");
}
예외
destinationFileName
은(는) null입니다.
호출자가 필요한 권한을 가지고 있지 않습니다.
destinationFileName
이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.
파일 destinationFileName
에 대한 액세스가 거부되었습니다.
지정된 destinationFileName
, 파일 이름, 또는 둘 다 시스템에서 정의한 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
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"));
}
예외
호출자가 destination
을(를) 열기 위한 필요한 권한을 가지고 있지 않습니다.
파일 경로가 비어 있거나 공백만 포함합니다.
파일을 찾을 수 없습니다.
파일 경로가 읽기 전용이거나 디렉터리입니다.
destination
은(는) null입니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
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");
}
예외
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");
}
예외
호출자가 fileInfo
을(를) 열기 위한 필요한 권한을 가지고 있지 않습니다.
파일 경로가 비어 있거나 공백만 포함합니다.
파일을 찾을 수 없습니다.
파일 경로가 읽기 전용이거나 디렉터리입니다.
fileInfo
은(는) null입니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
SetSource(string)
아카이브 내에서 압축할 내용을 설정합니다.
public void SetSource(string path)
매개변수
path
string
압축할 파일의 경로입니다.
예제
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
예외
path
은(는) null입니다.
호출자가 필요한 권한을 가지고 있지 않습니다.
path
이(가) 비어 있거나, 공백만 포함하거나, 잘못된 문자가 포함되어 있습니다.
파일 path
에 대한 액세스가 거부되었습니다.
지정된 path
, 파일 이름 또는 둘 다 시스템에서 정의한 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
path
에 문자열 중간에 콜론(:)이 포함되어 있습니다.