Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
Lớp này đại diện cho tệp lưu trữ LZMA. Sử dụng nó để tạo hoặc trích xuất các lưu trữ LZMA.
public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry
Kế thừa
Thực hiện
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
LzmaArchive(LzmaArchiveSettings)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.LZMA.LzmaArchive và tạo lưu trữ ở định dạng lzma.
public LzmaArchive(LzmaArchiveSettings settings = null)
Tham số
settings
LzmaArchiveSettings
Tập hợp các cài đặt cho lưu trữ lzma cụ thể.
LzmaArchive(Stream)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.LZMA.LzmaArchive được chuẩn bị để giải nén.
public LzmaArchive(Stream source)
Tham số
source
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.LZMA.LzmaArchive.Extract(System.IO.Stream) để giải nén.
Ngoại lệ
source
không thể tìm kiếm.
source
là null.
LzmaArchive(string)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.LZMA.LzmaArchive được chuẩn bị để giải nén.
public LzmaArchive(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 LzmaArchive(sourceLzmaFile))
{
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.LZMA.LzmaArchive.Extract(System.IO.Stream) để giải nén.
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 ký tự không hợp lệ.
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 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ự.
Tệp tại path
chứa một dấu hai chấm (:) ở giữa chuỗi.
Phương thức
Dispose()
Thực hiện các tác vụ do ứng dụng định nghĩa 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ụ do ứng dụng định nghĩa 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)
Trích xuất lưu trữ lzma đến một dòng.
public void Extract(Stream destination)
Tham số
destination
Stream
Dòng để lưu trữ dữ liệu đã giải nén.
Ví dụ
using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
}
Ngoại lệ
Tiêu đề và thông tin dịch vụ của lưu trữ chưa được đọc.
Lưu trữ bị hỏng.
Dòng đích là null.
Dòng đích không hỗ trợ việc ghi.
Extract(FileInfo)
Trích xuất lưu trữ lzma đến 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 lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Ngoại lệ
Tiêu đề và thông tin dịch vụ của lưu trữ chưa được đọc.
Người gọi không có quyền cần thiết để mở fileInfo
.
Đường dẫn tệp trống hoặc chỉ chứa khoảng trắng.
Tệp không được tìm thấy.
Đường dẫn đến tệp là chỉ đọc hoặc là một thư mục.
fileInfo
là null.
Đườ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ạ.
Tệp đã được mở.
Lưu trữ bị hỏng.
Extract(string)
Trích xuất lưu trữ lzma đến 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 lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract("extracted.bin");
}
}
Ngoại lệ
Tiêu đề và thông tin dịch vụ của lưu trữ chưa được đọc.
path
là null.
Người gọi không có quyền cần thiết để truy cập.
path
trống, chỉ chứa khoảng trắng, hoặc chứa ký tự không hợp lệ.
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 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ự.
Tệp tại path
chứa một dấu hai chấm (:) ở giữa chuỗi.
Lưu trữ bị hỏng.
ExtractToDirectory(string)
Trích xuất nội dung của lưu trữ đến 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 đã trích xuất vào.
Nhận xét
Nếu thư mục không tồn tại, nó sẽ được tạo ra.
Ngoại lệ
destinationDirectory
là null.
Đườ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ự.
Người gọi không có quyền cần thiết để truy cập thư mục hiện có.
Nếu thư mục không tồn tại, đường dẫn chứa một ký tự hai chấm (:) không phải là một phần của nhãn ổ đĩa (“C:").
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 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ự hai chấm (:).
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.
Lưu trữ bị hỏng.
Save(Stream)
Lưu lưu trữ lzma vào dòng được cung cấp.
public void Save(Stream output)
Tham số
output
Stream
Dòng đích.
Ví dụ
using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save(lzmaFile);
}
}
Nhận xét
output
phải có thể tìm kiếm.
Ngoại lệ
output
không hỗ trợ việc tìm kiếm.
output
là null.
Save(FileInfo)
Lưu lưu trữ lzma vào tệp đích được cung cấp.
public void Save(FileInfo destination)
Tham số
destination
FileInfo
FileInfo sẽ được mở dưới dạng dòng đích.
Ví dụ
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lzma"));
}
Ngoại lệ
Người gọi không có quyền cần thiết để mở destination
.
Đường dẫn tệp trống hoặc chỉ chứa khoảng trắng.
Tệp không được tìm thấy.
Đường dẫn đến tệp là chỉ đọc hoặc là một thư mục.
destination
là null.
Đườ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ạ.
Tệp đã được mở.
Save(string)
Lưu lưu trữ lzma vào tệp đích được 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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lzma");
}
Ngoại lệ
destinationFileName
là null.
Người gọi không có quyền cần thiết để truy cập.
destinationFileName
trống, chỉ chứa khoảng trắng, hoặc chứa ký tự không hợp lệ.
Truy cập vào tệp destinationFileName
bị từ chối.
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ự.
Tệp tại destinationFileName
chứa một dấu hai chấm (:) ở giữa chuỗi.
SetSource(Stream)
Đặt nội dung sẽ được nén trong lưu trữ.
public void SetSource(Stream source)
Tham số
source
Stream
Dòng đầu vào cho lưu trữ.
Ví dụ
using (var archive = new LzmaArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lzma");
}
Ngoại lệ
Dò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 dòng đầu vào.
Ví dụ
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lzma");
}
Ngoại lệ
Người gọi không có quyền cần thiết để mở fileInfo
.
Đường dẫn tệp trống hoặc chỉ chứa khoảng trắng.
Tệp không được tìm thấy.
Đường dẫn đến tệp là chỉ đọc hoặc là một thư mục.
fileInfo
là null.
Đườ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ạ.
Tệp đã được mở.
SetSource(string)
Đặt 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ở dưới dạng dòng đầu vào.
Ví dụ
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
Ngoại lệ
sourcePath
là null.
Người gọi không có quyền cần thiết để truy cập.
sourcePath
trống, chỉ chứa khoảng trắng, hoặc chứa ký tự không hợp lệ.
Truy cập vào tệp sourcePath
bị từ chối.
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 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ự.
Tệp tại sourcePath
chứa một dấu hai chấm (:) ở giữa chuỗi.