Class LzipArchive

Class LzipArchive

Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)

Lớp này đại diện cho tệp lưu trữ Lzip. Sử dụng nó để tạo hoặc trích xuất các lưu trữ Lzip.

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

Kế thừa

objectLzipArchive

Triển khai

IArchive, IDisposable, IArchiveFileEntry

Thành viên kế thừa

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Các hàm khởi tạo

LzipArchive(LzipArchiveSettings)

Khởi tạo một thể hiện mới của Aspose.Zip.Lzip.LzipArchive.

public LzipArchive(LzipArchiveSettings settings = null)

Tham số

settings LzipArchiveSettings

Cài đặt của lưu trữ lzip cụ thể với định nghĩa kích thước từ điển.

LzipArchive(Stream)

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Lzip.LzipArchive đã chuẩn bị để giải nén.

public LzipArchive(Stream sourceStream)

Tham số

sourceStream Stream

Nguồn của lưu trữ.

Nhận xét

Hàm khởi tạo này không giải nén. Xem phương thức Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) để giải nén.

Ngoại lệ

ArgumentException

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

ArgumentNullException

sourceStream là null.

InvalidDataException

Các tiêu đề không khớp với loại lưu trữ lzip.

LzipArchive(string)

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Lzip.LzipArchive đã chuẩn bị để giải nén.

public LzipArchive(string path)

Tham số

path string

Đường dẫn đến nguồn của lưu trữ.

Ví dụ

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new LzipArchive(sourceLzipFile))
    {
         archive.Extract(extractedFile);
       }
   }

Nhận xét

Hàm khởi tạo này không giải nén. Xem phương thức Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) để giải nén.

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 ký tự không hợp lệ.

UnauthorizedAccessException

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 dựa trên Windows, đường dẫn phải ít hơn 248 ký tự và tên tệp phải ít 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 không được ánh xạ.

IOException

Tệp đã mở.

InvalidDataException

Các tiêu đề không khớp với loại lưu trữ lzip.

Thuộc tính

Settings

Lấy cài đặt của lưu trữ lzip cụ thể.

public LzipArchiveSettings Settings { get; }

Giá trị thuộc tính

LzipArchiveSettings

Phương thức

Dispose()

Thực hiện các tác vụ được xác định bởi ứng dụng liên quan đến việc giải phóng, phát hành hoặc đặt lại tài nguyên không quản lý.

public void Dispose()

Dispose(bool)

Thực hiện các tác vụ được xác định bởi ứng dụng liên quan đến việc giải phóng, phát hành hoặc đặt lại tài nguyên không quản lý.

protected virtual void Dispose(bool disposing)

Tham số

disposing bool

Liệu các tài nguyên quản lý có nên được giải phóng hay không.

Extract(Stream)

Giải nén lưu trữ lzip vào một luồng.

public void Extract(Stream destination)

Tham số

destination Stream

Luồng để lưu trữ dữ liệu đã giải nén.

Ví dụ

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);
        }
   }
}

Ngoại lệ

InvalidOperationException

Các tiêu đề lưu trữ và thông tin dịch vụ chưa được đọc.

InvalidDataException

Lỗi trong dữ liệu trong tiêu đề hoặc kiểm tra tổng.

ArgumentNullException

Luồng đích là null.

ArgumentException

Luồng đích không hỗ trợ ghi.

Extract(FileInfo)

Giải nén lưu trữ lzip vào một tệp.

public void Extract(FileInfo fileInfo)

Tham số

fileInfo FileInfo

FileInfo để lưu trữ dữ liệu đã giải nén.

Ví dụ

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(lzipFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Ngoại lệ

InvalidOperationException

Các tiêu đề lưu trữ và thông tin dịch vụ chưa được đọc.

SecurityException

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

ArgumentException

Đường dẫn tệp trống hoặc chỉ chứa khoảng trắng.

FileNotFoundException

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

UnauthorizedAccessException

Đường dẫn đến tệp là chỉ đọc hoặc là một thư mục.

ArgumentNullException

fileInfo là null.

DirectoryNotFoundException

Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.

IOException

Tệp đã mở.

Extract(string)

Giải nén lưu trữ lzip vào một tệp theo đường dẫn.

public void Extract(string path)

Tham số

path string

Đường dẫn đến tệp sẽ lưu trữ dữ liệu đã giải nén.

Ví dụ

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(xzFile))
    {
        archive.Extract("extracted.bin");
    }
}

Ngoại lệ

InvalidOperationException

Các tiêu đề lưu trữ và thông tin dịch vụ chưa được đọc.

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 ký tự không hợp lệ.

UnauthorizedAccessException

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 dựa trên Windows, đường dẫn phải ít hơn 248 ký tự và tên tệp phải ít hơn 260 ký tự.

NotSupportedException

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

ExtractToDirectory(string)

Giải nén nội dung của lưu trữ vào thư mục đã cung cấp.

public void ExtractToDirectory(string destinationDirectory)

Tham số

destinationDirectory string

Đường dẫn đến thư mục để đặt các tệp đã giải nén.

Nhận xét

Nếu thư mục không tồn tại, nó sẽ được tạo.

Ngoại lệ

ArgumentNullException

destinationDirectory là null.

PathTooLongException

Đường dẫn được chỉ định, 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 dựa trên Windows, đường dẫn phải ít hơn 248 ký tự và tên tệp phải ít hơn 260 ký tự.

SecurityException

Người gọi không có quyền truy cập cần thiết vào thư mục hiện có.

NotSupportedException

Nếu thư mục không tồn tại, đường dẫn chứa ký tự dấu hai chấm (:) không phải là một phần của nhãn ổ đĩa (“C:").

ArgumentException

destinationDirectory là chuỗi có độ dài bằng không, chỉ chứa khoảng trắng hoặc chứa một hoặc nhiều ký tự không hợp lệ. Bạn có thể truy vấn các ký tự không hợp lệ bằng cách sử dụng phương thức System.IO.Path.GetInvalidPathChars. -hoặc- đường dẫn được tiền tố bằng, hoặc chỉ chứa, chỉ một ký tự dấu hai chấm (:).

IOException

Thư mục được chỉ định bởi đường dẫn là một tệp. -hoặc- Tên mạng không được biết.

Save(Stream)

Lưu lưu trữ lzip vào luồng đã cung cấp.

public void Save(Stream outputStream)

Tham số

outputStream Stream

Luồng đích.

Ví dụ

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

Nhận xét

outputStream phải có thể tìm kiếm.

Ngoại lệ

ArgumentException

outputStream không hỗ trợ tìm kiếm.

ArgumentNullException

outputStream là null.

Save(string)

Lưu lưu trữ lzip vào tệp đích đã cung cấp.

public void Save(string destinationFileName)

Tham số

destinationFileName string

Đường dẫn của lưu trữ sẽ được tạo. Nếu tên tệp được chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

Ví dụ

using (var archive = new LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lz");
}

Ngoại lệ

ArgumentNullException

destinationFileName là null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Truy cập vào tệp destinationFileName bị từ chối.

PathTooLongException

destinationFileName, 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 dựa trên Windows, đường dẫn phải ít hơn 248 ký tự và tên tệp phải ít hơn 260 ký tự.

NotSupportedException

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

Save(FileInfo)

Lưu lưu trữ lzip vào tệp đích đã cung cấp.

public void Save(FileInfo destination)

Tham số

destination FileInfo

FileInfo sẽ được mở dưới dạng luồng đích.

Ví dụ

using (var archive = new LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lz"));
}

Ngoại lệ

SecurityException

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

ArgumentException

Đường dẫn tệp trống hoặc chỉ chứa khoảng trắng.

FileNotFoundException

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

UnauthorizedAccessException

Đường dẫn đến tệp là chỉ đọc hoặc là một thư mục.

ArgumentNullException

destination là null.

DirectoryNotFoundException

Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.

IOException

Tệp đã mở.

SetSource(Stream)

Đặt nội dung sẽ được nén trong lưu trữ.

public void SetSource(Stream source)

Tham số

source Stream

Luồng đầu vào cho lưu trữ.

Ví dụ

using (var archive = new LzipArchive())
   {
       archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
       archive.Save("archive.lz");
}

Ngoại lệ

ArgumentException

Luồng source không thể tìm kiếm.

SetSource(FileInfo)

Đặt nội dung sẽ được nén trong lưu trữ.

public void SetSource(FileInfo fileInfo)

Tham số

fileInfo FileInfo

FileInfo sẽ được mở dưới dạng luồng đầu vào.

Ví dụ

using (var archive = new LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lz");
}

Ngoại lệ

SecurityException

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

ArgumentException

Đường dẫn tệp trống hoặc chỉ chứa khoảng trắng.

FileNotFoundException

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

UnauthorizedAccessException

Đường dẫn đến tệp là chỉ đọc hoặc là một thư mục.

ArgumentNullException

fileInfo là null.

DirectoryNotFoundException

Đường dẫn được chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.

IOException

Tệp đã mở.

SetSource(string)

Đặt nội dung sẽ được nén trong lưu trữ.

public void SetSource(string path)

Tham số

path string

Đường dẫn đến tệp sẽ được nén.

Ví dụ

using (var archive = new LzipArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz");
}

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 ký tự không hợp lệ.

UnauthorizedAccessException

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 dựa trên Windows, đường dẫn phải ít hơn 248 ký tự và tên tệp phải ít hơn 260 ký tự.

NotSupportedException

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

 Tiếng Việt