Class ZArchive

Class ZArchive

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

Lớp này đại diện cho một tập tin lưu trữ Z (compress). sử dụng nó để tạo hoặc rút các tập tin Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

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()

Remarks

Xem https://docs.fileformat.com/compression/z/

Constructors

Tài liệu()

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Z.Archive chuẩn bị cho việc nén.

public ZArchive()

Tài liệu(Stream, ZArchiveLoadOptions)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Z.Archive chuẩn bị cho việc phá vỡ.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

Nguồn gốc của Archive.

loadOptions ZArchiveLoadOptions

Các tùy chọn để tải file với.

Remarks

Xem Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) phương pháp để giảm bớt.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Tài liệu(Tính năng: ZArchiveLoadOptions)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Z.Archive chuẩn bị cho việc phá vỡ.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Con đường đến nguồn tài liệu.

loadOptions ZArchiveLoadOptions

Các tùy chọn để tải file với.

Remarks

Xem Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) phương pháp để giảm bớt.

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.

FileNotFoundException

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

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.

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(Stream)

Tiết xuất Z lưu trữ vào một dòng.

public void Extract(Stream destination)

Parameters

destination Stream

Stream để lưu trữ dữ liệu bị trộn.

Examples

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

Exceptions

InvalidDataException

Dữ liệu không thể bị phá vỡ.

Extract(FileInfo)

Tiết xuất Z lưu trữ vào một file.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo để lưu trữ dữ liệu bị phá vỡ.

Examples

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

Exceptions

SecurityException

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

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

fileInfo’ 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.

InvalidDataException

Dữ liệu không thể bị phá vỡ.

Extract(String)

Tiết xuất Z lưu trữ vào một tệp theo con đường.

public FileInfo Extract(string path)

Parameters

path string

Con đường đến file mà sẽ lưu trữ dữ liệu bị nén.

Returns

FileInfo

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

Examples

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

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.

InvalidDataException

Dữ liệu không thể bị phá vỡ.

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.

Save(Stream, ZArchiveSaveOptions)

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

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

Destination dòng

settings ZArchiveSaveOptions

Cài đặt tùy chọn cho thành phần lưu trữ.

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

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

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Thẻ, ZArchiveSaveOptions)

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

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

+Cách lưu trữ để được tạo.Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

settings ZArchiveSaveOptions

Cài đặt tùy chọn cho thành phần lưu trữ.

Examples

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

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.

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 ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo sẽ được mở như dòng nhập.

Examples

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

Exceptions

SecurityException

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

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

fileInfo’ 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.

SetSource(String)

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

public void SetSource(string sourcePath)

Parameters

sourcePath string

Đường đến file mà sẽ được mở như dòng nhập.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

Tên tệp được chỉ định sourcePath, 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 ở sourcePath’ chứa một cột (:) ở giữa dòng.

 Tiếng Việt