Class Lz4Archive

Class Lz4Archive

Tên không gian: Aspose.Zip.Lz4 Tổng hợp: Aspose.Zip.dll (25.5.0)

Lớp này đại diện cho tệp lưu trữ LZ4. sử dụng nó để lấy hoặc tạo thành các tập tin.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Thành viên thừa kế

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

Constructors

Lz4Archive(Stream)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Lz4.Lz4Archive chuẩn bị để giảm bớt.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

Nguồn gốc của Archive.

Examples

Mở một tập tin từ một dòng và rút nó vào một

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
  archive.Open().CopyTo(ms);

Remarks

Máy xây dựng này không bị trộn. Xem Aspose.Zip.Lz4.Lz4Archive.Open phương pháp trộn.

Exceptions

ArgumentException

Không thể đọc từ sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

sourceStream’ có chữ ký sai.

Lz4Archive(String)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Lz4.Lz4Archive.

public Lz4Archive(string path)

Parameters

path string

Cách di chuyển đến file file.

Examples

Mở một tập tin từ tệp theo con đường và rút nó vào một

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

Remarks

Máy xây dựng này không bị trộn. Xem Aspose.Zip.Lz4.Lz4Archive.Open phương pháp trộn.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập

ArgumentException

Đường path’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

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

PathTooLongException

Lối đi path", tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, các con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

Tệp ở path’ chứa một cột (:) ở giữa dòng.

EndOfStreamException

file quá ngắn.

InvalidDataException

Dữ liệu trong tệp có chữ ký sai.

Lz4Archive(Lz4ArchiveSetting)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Lz4. Lz4Archive chuẩn bị để nén.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

Cấu hình của các tập tin composite.

Methods

Dispose()

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

public void Dispose()

Dispose(Bool)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

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

Extract(String)

Tiết xuất tài liệu vào tệp theo con đường.

public FileInfo Extract(string path)

Parameters

path string

Đường đến tập tin đích. nếu tập tin đã tồn tại, nó sẽ được viết quá.

Returns

FileInfo

Thông tin về một tập tin được rút ra.

Exceptions

EndOfStreamException

Nguồn chảy quá ngắn.

InvalidDataException

Các byte sai được tìm thấy trong khi decoding.

NotSupportedException

Phiên bản LZ4 này không được hỗ trợ.

Extract(Stream)

Tải lưu trữ vào dòng được cung cấp.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. phải được viết.

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Nguồn chảy quá ngắn.

InvalidDataException

Các byte sai được tìm thấy trong khi decoding.

NotSupportedException

Phiên bản LZ4 này không được hỗ trợ.

InvalidOperationException

Tài liệu được chuẩn bị cho thành phần.

ExtractToDirectory(String)

Thu thập nội dung của lưu trữ vào thư mục được cung cấp.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Con đường đến thư mục để đặt các tập tin được lấy vào.

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Các con đường cụ thể, tên tệp hoặc cả hai đều vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, con đường phải nhỏ hơn 248 ký tự và tên tệp phải nhỏ hơn 260 ký tự.

SecurityException

Người gọi không có giấy phép 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, con đường chứa một ký tự vỏ (:) không phải là một phần của một nhãn ổ đĩa (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

Danh mục được chỉ định theo con đường là một tệp. -or- Tên mạng không được biết.

EndOfStreamException

Nguồn chảy quá ngắn.

InvalidDataException

Các byte sai được tìm thấy trong khi khởi động decoding.

InvalidOperationException

Tài liệu được chuẩn bị cho thành phần.

Open()

Mở lưu trữ để khai thác và cung cấp một dòng với nội dung lưu trữ.

public Stream Open()

Returns

Stream

dòng mà đại diện cho nội dung của lưu trữ.

Examples

Loại bỏ các tập tin và sao chép nội dung được lấy vào file stream.

using (var archive = new Lz4Archive("archive.lz4"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Bạn có thể sử dụng phương pháp Stream.CopyTo cho .NET 4.0 và cao hơn: ‘unpacked.Kopy To(từ);’

Remarks

Đọc từ dòng để có được nội dung ban đầu của một tệp. Xem phần ví dụ.

Exceptions

EndOfStreamException

Nguồn chảy quá ngắn.

InvalidDataException

Các byte sai được tìm thấy trong khi khởi động decoding.

InvalidOperationException

Tài liệu được chuẩn bị cho thành phần.

Save(Stream)

Tiết kiệm lưu trữ lz4 cho dòng cung cấp.

public void Save(Stream output)

Parameters

output Stream

Destination dòng

Examples

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

Remarks

phải được tìm kiếm.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Tài liệu được chuẩn bị cho khai thác. - hoặc - Nguồn không được cung cấp.

Save(FileInfo)

Tiết kiệm file lz4 đến tập tin đích được cung cấp.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, sẽ được mở như là dòng đích.

Examples

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

Exceptions

SecurityException

Người gọi không có quyền được yêu cầu để mở destination".

ArgumentException

Đường file là trống hoặc chỉ chứa không gian trắng.

FileNotFoundException

file không được tìm thấy.

UnauthorizedAccessException

Con đường đến file là chỉ đọc hoặc là một thư mục.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Con đường được chỉ định là vô hiệu, chẳng hạn như ở trên một ổ đĩa không được vẽ.

IOException

Tệp đã mở rồi.

InvalidOperationException

Tài liệu được chuẩn bị cho việc khai thác.

Save(String)

Tiết kiệm lưu trữ đến tệp đích được cung cấp.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập

ArgumentException

destinationFileName’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

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

PathTooLongException

Mục đích destinationFileName’, tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

File tại destinationFileName’ chứa một cột (:) ở giữa dòng.

InvalidOperationException

Tài liệu được chuẩn bị cho việc khai thác.

SetSource(Stream)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(Stream source)

Parameters

source Stream

dòng nhập vào lưu trữ.

Examples

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

Exceptions

InvalidOperationException

Tài liệu được chuẩn bị cho việc khai thác.

SetSource(FileInfo)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Các tham chiếu đến một tệp để được nén.

Examples

Mở một tập tin từ một dòng và rút nó vào một

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

Exceptions

InvalidOperationException

Tài liệu được chuẩn bị cho việc khai thác.

SetSource(Trang chủ, TarFormat)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

Tài liệu Tar để được nén.

format TarFormat

Định nghĩa Tar Header Format.

Examples

using (var tarArchive = new TarArchive())
{
    tarArchive.CreateEntry("first.bin", "data1.bin");
    tarArchive.CreateEntry("second.bin", "data2.bin");
    using (var lz4Archive = new Lz4Archive())
    {
        lz4Archive.SetSource(tarArchive);
        lz4Archive.Save("archive.tar.lz4");
    }
}

Remarks

Sử dụng phương pháp này để kết hợp tập tin tar.lz4.

SetSource(String)

Đặt nội dung để được nén trong hồ sơ.

public void SetSource(string path)

Parameters

path string

Cách để file để được nén.

Examples

Mở một tập tin từ tệp theo con đường và rút nó vào một

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Người gọi không có giấy phép cần thiết để truy cập

ArgumentException

Đường path’ là trống, chỉ chứa các không gian trắng, hoặc chứa các ký tự vô hiệu.

UnauthorizedAccessException

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

PathTooLongException

Lối đi path", tên tệp, hoặc cả hai vượt quá chiều dài tối đa được xác định bởi hệ thống. Ví dụ, trên nền tảng dựa trên Windows, các con đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

Tệp ở path’ chứa một cột (:) ở giữa dòng.

InvalidOperationException

Tài liệu này được chuẩn bị cho việc khai thác.

 Tiếng Việt