Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
ISO 아카이브(ISO 9660)를 나타냅니다.
public sealed class IsoArchive : IArchive, IDisposable
상속
구현
상속된 멤버
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
생성자
IsoArchive()
Aspose.Zip.Iso.IsoArchive 클래스의 새 인스턴스를 초기화하고 새로운 파일 및 디렉터리를 추가하기 위한 빈 ISO 아카이브를 생성합니다.
public IsoArchive()
예제
다음 예제는 새로운 빈 ISO 아카이브를 생성하고 파일을 추가하는 방법을 보여줍니다:
// 새로운 빈 ISO 아카이브 생성
using(IsoArchive isoArchive = new IsoArchive())
{
// ISO 아카이브에 파일 추가
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// ISO 아카이브를 파일로 저장
isoArchive.Save("new_archive.iso");
}
IsoArchive(Stream, IsoLoadOptions)
Aspose.Zip.Iso.IsoArchive 클래스의 새 인스턴스를 초기화하고 아카이브에서 추출할 수 있는 항목 목록을 구성합니다.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)
매개변수
sourceStream
Stream
아카이브의 소스입니다. 탐색 가능해야 합니다.
loadOptions
IsoLoadOptions
아카이브를 로드하는 옵션입니다.
예제
다음 예제는 모든 항목을 디렉터리로 추출하는 방법을 보여줍니다.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
비고
이 생성자는 어떤 항목도 압축 해제하지 않습니다.
예외
sourceStream
가 null입니다.
sourceStream
가 탐색 불가능합니다.
sourceStream
가 유효한 ISO 아카이브가 아닙니다.
IsoArchive(string, IsoLoadOptions)
Aspose.Zip.Iso.IsoArchive 클래스의 새 인스턴스를 초기화하고 아카이브에서 추출할 수 있는 항목 목록을 구성합니다.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)
매개변수
path
string
아카이브 파일의 경로입니다.
loadOptions
IsoLoadOptions
아카이브를 로드하는 옵션입니다.
예제
다음 예제는 모든 항목을 디렉터리로 추출하는 방법을 보여줍니다.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}
비고
이 생성자는 어떤 항목도 압축 해제하지 않습니다.
예외
path
가 null입니다.
호출자가 액세스할 수 있는 필수 권한이 없습니다.
path
가 비어 있거나 공백만 포함하거나 잘못된 문자를 포함합니다.
path
에 대한 파일 접근이 거부되었습니다.
지정된 path
, 파일 이름 또는 둘 다가 시스템 정의 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하고, 파일 이름이 260자 미만이어야 합니다.
path
의 문자열 중간에 콜론(:)이 포함되어 있습니다.
파일을 찾을 수 없습니다.
지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).
파일이 이미 열려 있습니다.
파일이 너무 짧습니다.
속성
Entries
아카이브를 구성하는 Aspose.Zip.Iso.IsoEntry 유형의 항목을 가져옵니다.
public ReadOnlyCollection<isoentry> Entries { get; }
속성 값
ReadOnlyCollection<IsoEntry>
메서드
CreateDirectory(string)
ISO 이미지에 디렉터리를 추가합니다.
public IsoEntry CreateDirectory(string name)
매개변수
name
string
ISO 내 디렉터리의 경로입니다.
반환
구성된 ISO 항목입니다.
예외
아카이브가 추출을 위해 열려 있습니다.
name
가 null이거나 비어 있습니다.
CreateEntry(string, string)
ISO 이미지에 파일을 추가합니다.
public IsoEntry CreateEntry(string name, string filePath)
매개변수
name
string
ISO 내 파일의 경로입니다.
filePath
string
파일의 경로입니다.
반환
구성된 ISO 항목입니다.
예외
filePath
가 null입니다.
filePath
가 비어 있거나 공백만 포함하거나 잘못된 문자를 포함합니다.
filePath
에 대한 파일 접근이 거부되었습니다.
지정된 filePath
가 시스템 정의 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서는 경로가 248자 미만이어야 하고, 파일 이름이 260자 미만이어야 합니다.
filePath
에 콜론(:)이 포함되어 있습니다.
파일을 여는 동안 I/O 오류가 발생했습니다.
CreateEntry(string, Stream)
ISO 이미지에 파일을 추가합니다.
public IsoEntry CreateEntry(string name, Stream source)
매개변수
name
string
ISO 내 파일의 경로입니다.
source
Stream
파일 데이터가 포함된 스트림입니다.
반환
구성된 ISO 항목입니다.
CreateEntry(string)
ISO 이미지에 파일을 추가합니다.
public IsoEntry CreateEntry(string name)
매개변수
name
string
ISO 내 디렉터리의 경로입니다.
반환
구성된 ISO 항목입니다.
예외
name
가 null이거나 비어 있습니다.
아카이브가 추출을 위해 열려 있습니다.
Dispose()
비관리 리소스를 해제, 해방 또는 재설정하는 애플리케이션 정의 작업을 수행합니다.
public void Dispose()
ExtractToDirectory(string)
모든 항목을 지정된 디렉터리로 추출합니다.
public void ExtractToDirectory(string destinationDirectory)
매개변수
destinationDirectory
string
항목을 추출할 디렉터리입니다.
예제
다음 예제는 모든 항목을 디렉터리로 추출하는 방법을 보여줍니다:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
예외
아카이브가 편집 모드일 때 발생합니다.
destinationDirectory
가 null일 때 발생합니다.
Save(string, IsoSaveOptions)
ISO 이미지를 지정된 경로에 저장합니다.
public void Save(string path, IsoSaveOptions saveOptions = null)
매개변수
path
string
ISO 이미지가 저장될 경로입니다.
saveOptions
IsoSaveOptions
ISO 아카이브를 저장하는 옵션입니다.
예제
다음 예제는 ISO 아카이브를 파일로 저장하는 방법을 보여줍니다:
// 새로운 빈 ISO 아카이브 생성
using(IsoArchive isoArchive = new IsoArchive())
{
// ISO 아카이브에 파일 추가
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// ISO 아카이브를 파일로 저장
isoArchive.Save("new_archive.iso");
}
예외
아카이브가 편집 모드가 아닐 때 발생합니다.
path
가 null일 때 발생합니다.
지정된 경로가 잘못되었을 때 발생합니다(예: 매핑되지 않은 드라이브에 있음).
파일이 이미 열려 있을 때 발생합니다.
path
에 대한 파일 접근이 거부되었을 때 발생합니다.
지정된 path
가 시스템 정의 최대 길이를 초과할 때 발생합니다.
Save(Stream, IsoSaveOptions)
ISO 이미지를 지정된 스트림에 저장합니다.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)
매개변수
stream
Stream
ISO 이미지가 저장될 스트림입니다.
saveOptions
IsoSaveOptions
ISO 아카이브를 저장하는 옵션입니다.
예제
다음 예제는 ISO 아카이브를 메모리 스트림에 저장하는 방법을 보여줍니다:
// 새로운 빈 ISO 아카이브 생성
using(IsoArchive isoArchive = new IsoArchive())
{
// ISO 아카이브에 파일 추가
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// ISO 아카이브를 메모리 스트림에 저장
isoArchive.Save(memoryStream);
}
예외
아카이브가 편집 모드가 아닐 때 발생합니다.
stream
가 null일 때 발생합니다.
stream
가 쓰기 불가능할 때 발생합니다.