Class XzArchive

Class XzArchive

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

Lớp này đại diện cho tệp lưu trữ xz. Sử dụng nó để tạo và giải nén các lưu trữ xz.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Kế thừa

objectXzArchive

Triển khai

IArchive, IDisposable, IArchiveFileEntry

Các 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

XzArchive(XzArchiveSettings)

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Xz.XzArchive và tạo lưu trữ ở định dạng xz.

public XzArchive(XzArchiveSettings settings = null)

Tham số

settings XzArchiveSettings

Tập hợp các cấu hình cho lưu trữ xz: kích thước từ điển, kích thước khối, loại kiểm tra.

XzArchive(Stream)

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

public XzArchive(Stream source)

Tham số

source Stream

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

Ghi chú

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

Ngoại lệ

ArgumentException

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

ArgumentNullException

source là null.

XzArchive(string)

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

public XzArchive(string path)

Tham số

path string

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

Ghi chú

Hàm khởi tạo này không giải nén. Xem phương thức Aspose.Zip.Xz.XzArchive.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 là rỗ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, đườ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 một 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ở.

Các phương thức

Dispose()

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

public void Dispose()

Dispose(bool)

Thực hiện các tác vụ được định nghĩa bởi ứng dụng liên quan đến việc giải phóng, phát hành hoặc thiết lập lại các 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 được quản lý có nên được giải phóng hay không.

Extract(Stream)

Giải nén lưu trữ xz 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 xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new XzArchive(xzFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Ngoại lệ

InvalidOperationException

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

Extract(FileInfo)

Giải nén lưu trữ xz 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 xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(xzFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Ngoại lệ

InvalidOperationException

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 cần thiết để mở fileInfo.

ArgumentException

Đường dẫn tệp là rỗ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ữ xz vào một tệp theo đường dẫn.

public FileInfo Extract(string path)

Tham số

path string

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

Trả về

FileInfo

Thể hiện System.IO.FileInfo chứa dữ liệu đã được giải nén.

Ví dụ

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

Ngoại lệ

InvalidOperationException

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 cần thiết để truy cập.

ArgumentException

path là rỗ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, đườ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 một 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ở.

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.

Ghi chú

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, 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, đườ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ự.

SecurityException

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

NotSupportedException

Nếu thư mục không tồn tại, đường dẫn chứa một 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à một 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 cho 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, 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 đến.

Save(Stream)

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

public void Save(Stream output)

Tham số

output Stream

Luồng đích.

Ví dụ

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

Ghi chú

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

Ngoại lệ

ArgumentException

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

ArgumentNullException

output là null.

Save(string)

Lưu trữ xz 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 đã chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

Ví dụ

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

Ngoại lệ

ArgumentNullException

destinationFileName là null.

SecurityException

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

ArgumentException

destinationFileName là rỗ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 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 Windows, đườ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 destinationFileName chứa một dấu hai chấm (:) ở giữa chuỗi.

SetSource(Stream)

Thiết lập 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 XzArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.xz");
}

Ngoại lệ

ArgumentException

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

SetSource(FileInfo)

Thiết lập nội dung sẽ được nén trong lưu trữ.

public void SetSource(FileInfo fileInfo)

Tham số

fileInfo FileInfo

FileInfo sẽ được mở như một luồng đầu vào.

Ví dụ

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

Ngoại lệ

SecurityException

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

ArgumentException

Đường dẫn tệp là rỗ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)

Thiết lập nội dung sẽ được nén trong lưu trữ.

public void SetSource(string sourcePath)

Tham số

sourcePath string

Đường dẫn đến tệp sẽ được mở như một luồng đầu vào.

Ví dụ

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

Ngoại lệ

ArgumentNullException

sourcePath là null.

SecurityException

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

ArgumentException

sourcePath là rỗ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 sourcePath bị từ chối.

PathTooLongException

sourcePath, 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, đườ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 sourcePath chứa một dấu hai chấm (:) ở giữa chuỗi.

 Tiếng Việt