Class IsoArchive

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

object ← IsoArchive

Triển khai

IArchive, IDisposable

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ệ

ArgumentNullException

sourceStream là null.

ArgumentException

sourceStream không thể tìm kiếm.

InvalidDataException

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ệ

ArgumentNullException

path là null.

SecurityException

Người gọi không có quyền truy cập cần thiết.

ArgumentException

path trống, chỉ chứa khoảng trắng hoặc chứa các ký tự không hợp lệ.

UnauthorizedAccessException

Quyền truy cập vào tệp path bị từ chối.

PathTooLongException

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ự.

NotSupportedException

Tệp tại path chứa dấu hai chấm (:) ở giữa chuỗi.

FileNotFoundException

Tệp không được tìm thấy.

DirectoryNotFoundException

Đườ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ạ.

IOException

Tệp đã được mở.

EndOfStreamException

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&gt;

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ề

IsoEntry

Mục ISO được tạo thành.

Ngoại lệ

InvalidOperationException

Kho lưu trữ đang mở để giải nén.

ArgumentNullException

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ề

IsoEntry

Mục ISO được tạo thành.

Ngoại lệ

ArgumentNullException

filePath là null.

ArgumentException

filePath trống, chỉ chứa khoảng trắng hoặc chứa các ký tự không hợp lệ.

UnauthorizedAccessException

Quyền truy cập vào tệp filePath bị từ chối.

PathTooLongException

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ự.

NotSupportedException

Tệp tại filePath chứa dấu hai chấm (:) ở giữa chuỗi.

IOException

Đã 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ề

IsoEntry

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ề

IsoEntry

Mục ISO được tạo thành.

Ngoại lệ

ArgumentNullException

name là null hoặc trống.

InvalidOperationException

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ệ

InvalidOperationException

Ném ra khi kho lưu trữ đang ở chế độ chỉnh sửa.

ArgumentNullException

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ệ

InvalidOperationException

Ném ra khi kho lưu trữ không ở chế độ chỉnh sửa.

ArgumentNullException

Ném ra khi path là null.

DirectoryNotFoundException

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ạ.

IOException

Ném ra khi tệp đã được mở.

UnauthorizedAccessException

Ném ra khi quyền truy cập vào tệp path bị từ chối.

PathTooLongException

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ệ

InvalidOperationException

Ném ra khi kho lưu trữ không ở chế độ chỉnh sửa.

ArgumentNullException

Ném ra khi stream là null.

ArgumentException

Ném ra khi stream không thể ghi.

 Tiếng Việt