Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Đại diện cho một kho lưu trữ ISO (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposable
Kế thừa
Triển khai
Các thành viên kế thừa
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Các hàm khởi tạo
IsoArchive()
Khởi tạo một thể hiện mới của lớp Aspose.Zip.Iso.IsoArchive và tạo một kho lưu trữ ISO trống để thêm các tệp và thư mục mới.
public IsoArchive()
Ví dụ
Ví dụ dưới đây cho thấy cách tạo một kho lưu trữ ISO trống mới và thêm tệp vào đó:
// Tạo một kho lưu trữ ISO trống mới
using(IsoArchive isoArchive = new IsoArchive())
{
// Thêm tệp vào kho lưu trữ ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Lưu kho lưu trữ ISO vào tệp
isoArchive.Save("new_archive.iso");
}
IsoArchive(Stream, IsoLoadOptions)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.Iso.IsoArchive và tạo danh sách các mục có thể được trích xuất từ kho lưu trữ.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)
Tham số
sourceStream
Stream
Nguồn của kho lưu trữ. Nó phải có thể tìm kiếm.
loadOptions
IsoLoadOptions
Các tùy chọn để tải kho lưu trữ.
Ví dụ
Ví dụ dưới đây cho thấy cách trích xuất tất cả các mục vào một thư mục.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
Nhận xét
Hàm khởi tạo này không giải nén bất kỳ mục nào.
Ngoại lệ
sourceStream
là null.
sourceStream
không thể tìm kiếm.
sourceStream
không phải là một kho lưu trữ ISO hợp lệ.
IsoArchive(string, IsoLoadOptions)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.Iso.IsoArchive và tạo danh sách các mục có thể được trích xuất từ kho lưu trữ.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)
Tham số
path
string
Đường dẫn đến tệp kho lưu trữ.
loadOptions
IsoLoadOptions
Các tùy chọn để tải kho lưu trữ.
Ví dụ
Ví dụ dưới đây cho thấy cách trích xuất tất cả các mục vào một thư mục.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}
Nhận xét
Hàm khởi tạo này không giải nén bất kỳ mục nào.
Ngoại lệ
path
là null.
Người gọi không có quyền truy cập cần thiết.
path
trống, chỉ chứa khoảng trắng hoặc chứa các ký tự không hợp lệ.
Quyền truy cập vào tệp path
bị từ chối.
path
, tên tệp hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng Windows, các đường dẫn phải ngắn hơn 248 ký tự và tên tệp phải ngắn hơn 260 ký tự.
Tệp tại path
chứa dấu hai chấm (:) ở giữa chuỗi.
Tệp không được tìm thấy.
Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa chưa được ánh xạ.
Tệp đã được mở.
Tệp quá ngắn.
Thuộc tính
Entries
Lấy các mục của loại Aspose.Zip.Iso.IsoEntry cấu thành kho lưu trữ.
public ReadOnlyCollection<isoentry> Entries { get; }
Giá trị thuộc tính
ReadOnlyCollection<IsoEntry>
Phương thức
CreateDirectory(string)
Thêm một thư mục vào hình ảnh ISO.
public IsoEntry CreateDirectory(string name)
Tham số
name
string
Đường dẫn của thư mục trong ISO.
Trả về
Mục ISO được tạo thành.
Ngoại lệ
Kho lưu trữ đang mở để giải nén.
name
là null hoặc trống.
CreateEntry(string, string)
Thêm một tệp vào hình ảnh ISO.
public IsoEntry CreateEntry(string name, string filePath)
Tham số
name
string
Đường dẫn của tệp trong ISO.
filePath
string
Đường dẫn của tệp.
Trả về
Mục ISO được tạo thành.
Ngoại lệ
filePath
là null.
filePath
trống, chỉ chứa khoảng trắng hoặc chứa các ký tự không hợp lệ.
Quyền truy cập vào tệp filePath
bị từ chối.
filePath
vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng Windows, các đường dẫn phải ngắn hơn 248 ký tự và tên tệp phải ngắn hơn 260 ký tự.
Tệp tại filePath
chứa dấu hai chấm (:) ở giữa chuỗi.
Đã xảy ra lỗi I/O khi mở tệp.
CreateEntry(string, Stream)
Thêm một tệp vào hình ảnh ISO.
public IsoEntry CreateEntry(string name, Stream source)
Tham số
name
string
Đường dẫn của tệp trong ISO.
source
Stream
Luồng chứa dữ liệu tệp.
Trả về
Mục ISO được tạo thành.
CreateEntry(string)
Thêm một tệp vào hình ảnh ISO.
public IsoEntry CreateEntry(string name)
Tham số
name
string
Đường dẫn của thư mục trong ISO.
Trả về
Mục ISO được tạo thành.
Ngoại lệ
name
là null hoặc trống.
Kho lưu trữ đang mở để giải nén.
Dispose()
Thực hiện các tác vụ do ứng dụng xác định liên quan đến việc giải phóng, phát hành hoặc đặt lại các tài nguyên không quản lý.
public void Dispose()
ExtractToDirectory(string)
Giải nén tất cả các mục vào thư mục được chỉ định.
public void ExtractToDirectory(string destinationDirectory)
Tham số
destinationDirectory
string
Thư mục để giải nén các mục vào.
Ví dụ
Ví dụ dưới đây cho thấy cách giải nén tất cả các mục vào một thư mục:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
Ngoại lệ
Ném ra khi kho lưu trữ đang ở chế độ chỉnh sửa.
Ném ra khi destinationDirectory
là null.
Save(string, IsoSaveOptions)
Lưu hình ảnh ISO vào đường dẫn được chỉ định.
public void Save(string path, IsoSaveOptions saveOptions = null)
Tham số
path
string
Đường dẫn nơi hình ảnh ISO sẽ được lưu.
saveOptions
IsoSaveOptions
Tùy chọn để lưu kho lưu trữ ISO.
Ví dụ
Ví dụ dưới đây cho thấy cách lưu một kho lưu trữ ISO vào một tệp:
// Tạo một kho lưu trữ ISO trống mới
using(IsoArchive isoArchive = new IsoArchive())
{
// Thêm tệp vào kho lưu trữ ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Lưu kho lưu trữ ISO vào một tệp
isoArchive.Save("new_archive.iso");
}
Ngoại lệ
Ném ra khi kho lưu trữ không ở chế độ chỉnh sửa.
Ném ra khi path
là null.
Ném ra khi đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa chưa được ánh xạ.
Ném ra khi tệp đã được mở.
Ném ra khi quyền truy cập vào tệp path
bị từ chối.
Ném ra khi path
vượt quá độ dài tối đa do hệ thống xác định.
Save(Stream, IsoSaveOptions)
Lưu hình ảnh ISO vào luồng được chỉ định.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)
Tham số
stream
Stream
Luồng nơi hình ảnh ISO sẽ được lưu.
saveOptions
IsoSaveOptions
Tùy chọn để lưu kho lưu trữ ISO.
Ví dụ
Ví dụ dưới đây cho thấy cách lưu một kho lưu trữ ISO vào một luồng bộ nhớ:
// Tạo một kho lưu trữ ISO trống mới
using(IsoArchive isoArchive = new IsoArchive())
{
// Thêm tệp vào kho lưu trữ ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Lưu kho lưu trữ ISO vào một luồng bộ nhớ
isoArchive.Save(memoryStream);
}
Ngoại lệ
Ném ra khi kho lưu trữ không ở chế độ chỉnh sửa.
Ném ra khi stream
là null.
Ném ra khi stream
không thể ghi.