Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
이 클래스는 LZMA 아카이브 파일을 나타냅니다. LZMA 아카이브를 구성하거나 추출하는 데 사용합니다.
public class LzmaArchive : 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()
생성자
LzmaArchive(LzmaArchiveSettings)
Aspose.Zip.LZMA.LzmaArchive 클래스의 새 인스턴스를 초기화하고 lzma 형식으로 아카이브를 구성합니다.
public LzmaArchive(LzmaArchiveSettings settings = null)
매개변수
settings
LzmaArchiveSettings
특정 lzma 아카이브의 설정 집합입니다.
LzmaArchive(Stream)
압축 해제를 위해 준비된 Aspose.Zip.LZMA.LzmaArchive 클래스의 새 인스턴스를 초기화합니다.
public LzmaArchive(Stream source)
매개변수
source
Stream
아카이브의 소스입니다.
비고
이 생성자는 압축 해제를 수행하지 않습니다. 압축 해제를 위한 Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) 메서드를 참조하십시오.
예외
source
는 탐색할 수 없습니다.
source
는 null입니다.
LzmaArchive(string)
압축 해제를 위해 준비된 Aspose.Zip.LZMA.LzmaArchive 클래스의 새 인스턴스를 초기화합니다.
public LzmaArchive(string path)
매개변수
path
string
아카이브의 소스 경로입니다.
예제
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
비고
이 생성자는 압축 해제를 수행하지 않습니다. 압축 해제를 위한 Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) 메서드를 참조하십시오.
예외
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)
lzma 아카이브를 스트림으로 추출합니다.
public void Extract(Stream destination)
매개변수
destination
Stream
압축 해제된 데이터를 저장할 스트림입니다.
예제
using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
}
예외
아카이브 헤더 및 서비스 정보를 읽지 않았습니다.
아카이브가 손상되었습니다.
대상 스트림이 null입니다.
대상 스트림이 쓰기를 지원하지 않습니다.
Extract(FileInfo)
lzma 아카이브를 파일로 추출합니다.
public void Extract(FileInfo fileInfo)
매개변수
fileInfo
FileInfo
압축 해제된 데이터를 저장할 FileInfo입니다.
예제
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
예외
아카이브 헤더 및 서비스 정보를 읽지 않았습니다.
호출자가 fileInfo
를 열 수 있는 권한이 없습니다.
파일 경로가 비어 있거나 공백만 포함되어 있습니다.
파일을 찾을 수 없습니다.
파일 경로가 읽기 전용이거나 디렉터리입니다.
fileInfo
는 null입니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
아카이브가 손상되었습니다.
Extract(string)
경로로 lzma 아카이브를 파일로 추출합니다.
public void Extract(string path)
매개변수
path
string
압축 해제된 데이터를 저장할 파일의 경로입니다.
예제
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
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)
제공된 스트림에 lzma 아카이브를 저장합니다.
public void Save(Stream output)
매개변수
output
Stream
대상 스트림입니다.
예제
using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save(lzmaFile);
}
}
비고
output
는 탐색 가능해야 합니다.
예외
output
는 탐색을 지원하지 않습니다.
output
는 null입니다.
Save(FileInfo)
제공된 대상 파일에 lzma 아카이브를 저장합니다.
public void Save(FileInfo destination)
매개변수
destination
FileInfo
대상 스트림으로 열릴 FileInfo입니다.
예제
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lzma"));
}
예외
호출자가 destination
를 열 수 있는 권한이 없습니다.
파일 경로가 비어 있거나 공백만 포함되어 있습니다.
파일을 찾을 수 없습니다.
파일 경로가 읽기 전용이거나 디렉터리입니다.
destination
는 null입니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
Save(string)
제공된 대상 파일에 lzma 아카이브를 저장합니다.
public void Save(string destinationFileName)
매개변수
destinationFileName
string
생성될 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키는 경우, 해당 파일은 덮어쓰여집니다.
예제
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lzma");
}
예외
destinationFileName
는 null입니다.
호출자가 액세스할 수 있는 권한이 없습니다.
destinationFileName
가 비어 있거나 공백만 포함하거나 잘못된 문자가 포함되어 있습니다.
destinationFileName
파일에 대한 액세스가 거부되었습니다.
지정된 destinationFileName
, 파일 이름 또는 둘 다 시스템에서 정의된 최대 길이를 초과합니다. 예를 들어 Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
destinationFileName
의 파일이 문자열 중간에 콜론(:)을 포함합니다.
SetSource(Stream)
아카이브 내에서 압축할 콘텐츠를 설정합니다.
public void SetSource(Stream source)
매개변수
source
Stream
아카이브의 입력 스트림입니다.
예제
using (var archive = new LzmaArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lzma");
}
예외
source
스트림은 탐색할 수 없습니다.
SetSource(FileInfo)
아카이브 내에서 압축할 콘텐츠를 설정합니다.
public void SetSource(FileInfo fileInfo)
매개변수
fileInfo
FileInfo
입력 스트림으로 열릴 FileInfo입니다.
예제
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lzma");
}
예외
호출자가 fileInfo
를 열 수 있는 권한이 없습니다.
파일 경로가 비어 있거나 공백만 포함되어 있습니다.
파일을 찾을 수 없습니다.
파일 경로가 읽기 전용이거나 디렉터리입니다.
fileInfo
는 null입니다.
지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.
파일이 이미 열려 있습니다.
SetSource(string)
아카이브 내에서 압축할 콘텐츠를 설정합니다.
public void SetSource(string sourcePath)
매개변수
sourcePath
string
입력 스트림으로 열릴 파일의 경로입니다.
예제
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
예외
sourcePath
는 null입니다.
호출자가 액세스할 수 있는 권한이 없습니다.
sourcePath
가 비어 있거나 공백만 포함하거나 잘못된 문자가 포함되어 있습니다.
sourcePath
파일에 대한 액세스가 거부되었습니다.
지정된 sourcePath
, 파일 이름 또는 둘 다 시스템에서 정의된 최대 길이를 초과합니다. 예를 들어 Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하며, 파일 이름은 260자 미만이어야 합니다.
sourcePath
의 파일이 문자열 중간에 콜론(:)을 포함합니다.