Class XarArchive

Class XarArchive

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

Lớp này đại diện cho một tệp lưu trữ xar.

public class XarArchive : IArchive, IDisposable

Inheritance

object XarArchive

Implements

IArchive , IDisposable

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

XarArchive(XarCompressionSettings)

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

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

Các cài đặt nén mặc định, áp dụng cho tất cả các bản ghi của lưu trữ.

Examples

Ví dụ sau đây cho thấy làm thế nào để nén một tệp.

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

XarArchive(Áp dụng, XarLoadOptions)

Bắt đầu một ví dụ mới của lớp Aspose.Zip.Xar.xarArchive và tạo ra một danh sách nhập có thể được rút ra từ lưu trữ.

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

Nguồn gốc của tài liệu. nó phải được tìm kiếm.

loadOptions XarLoadOptions

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

Examples

Ví dụ sau đây cho thấy làm thế nào để rút tất cả các mục vào một thư mục.

using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

Nhà sản xuất này không loại bỏ bất kỳ nhập khẩu. Xem Aspose.Zip.Xar.XarFileEntry.Open phương pháp để loại bỏ.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(Tính năng: XarLoadOptions)

Bắt đầu một ví dụ mới của lớp Aspose.Zip.Xar.xarArchive và tạo ra một danh sách nhập có thể được rút ra từ lưu trữ.

public XarArchive(string path, XarLoadOptions loadOptions = null)

Parameters

path string

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

loadOptions XarLoadOptions

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

Examples

Ví dụ sau đây cho thấy làm thế nào để rút tất cả các mục vào một thư mục.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

Nhà sản xuất này không loại bỏ bất kỳ nhập khẩu. Xem Aspose.Zip.Xar.XarFileEntry.Open phương pháp để loại bỏ.

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.

InvalidDataException

Tệp ở path’ không phải là lưu trữ xar hợp lệ.

Properties

Entries

Gets entries of Aspose.Zip.Xar.XarEntry type constituting the archive.

public IEnumerable<xarentry> Entries { get; }

Giá trị bất động sản

IEnumerable < XarEntry >

Methods

CreateEntries(xích, bool, XarCompressionSettings)

Thêm vào lưu trữ tất cả các tập tin và thư mục lặp lại trong thư mục được cung cấp.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

sourceDirectory string

Hướng dẫn làm compress.

includeRootDirectory bool

Nó chỉ ra liệu phải bao gồm bản địa gốc hay không.

compressionSettings XarCompressionSettings

Các cài đặt nén được sử dụng để thêm các mục Aspose.Zip.Xar.XarEntry.

Returns

XarArchive

Xã hội nhập cảnh.

Examples

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

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

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

Đường được chỉ định, 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, đường phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự. đường được chỉ định, tên tệp, hoặc cả hai quá dài.

IOException

sourceDirectory’ stands for a file, not for a directory.

CreateEntries(DirectoryInfo, bool, XarCompressionSettings)

Thêm vào lưu trữ tất cả các tập tin và thư mục lặp lại trong thư mục được cung cấp.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

directory DirectoryInfo

Hướng dẫn làm compress.

includeRootDirectory bool

Nó chỉ ra liệu phải bao gồm bản địa gốc hay không.

compressionSettings XarCompressionSettings

Các cài đặt nén được sử dụng để thêm các mục Aspose.Zip.Xar.XarEntry.

Returns

XarArchive

Xã hội nhập cảnh.

Examples

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

Exceptions

ArgumentNullException

directory’ is null.

SecurityException

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

IOException

directory’ stands for a file, not for a directory.

CreateEntry(string, FileInfo, bool, XarCompressionSettings)

Tạo một bản ghi duy nhất trong hồ sơ.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

Tên của entry.

fileInfo FileInfo

Các metadata của tệp hoặc thư mục để được nén.

openImmediately bool

Thật vậy, nếu bạn mở tệp ngay lập tức, nếu không mở tệp trên lưu trữ.

compressionSettings XarCompressionSettings

Các cài đặt nén được sử dụng để thêm Aspose.Zip.Xar.XarEntry mục.

Returns

XarEntry

Xã hội nhập cảnh.

Examples

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

Remarks

Nếu tệp được mở ngay lập tức với thông số, nó sẽ bị chặn cho đến khi lưu trữ bị xóa.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(string, string, bool, XarCompressionSettings)

Tạo một bản ghi duy nhất trong hồ sơ.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

Tên của entry.

sourcePath string

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

openImmediately bool

Thật vậy, nếu bạn mở tệp ngay lập tức, nếu không mở tệp trên lưu trữ.

compressionSettings XarCompressionSettings

Các cài đặt nén được sử dụng để thêm Aspose.Zip.Xar.XarEntry mục.

Returns

XarEntry

Xã hội nhập cảnh.

Examples

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

Remarks

Tên đăng nhập chỉ được đặt trong parameter. tên tệp được cung cấp trong parameter không ảnh hưởng đến tên đăng nhập.

Nếu tệp được mở ngay lập tức với thông số, nó sẽ bị chặn cho đến khi lưu trữ bị xóa.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

sourcePath’ là trống, chỉ chứa không gian trắng, hoặc chứa các ký tự bất hợp lệ. - hoặc - Tên tập tin, như một phần của name’, vượt quá 100 ký tự.

UnauthorizedAccessException

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

PathTooLongException

Ví dụ, trên các 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 tin phải nhỏ hơn 260 ký tự. - hoặc - name’ là quá dài cho xar.

NotSupportedException

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

InvalidOperationException

Không thể sửa đổi file xar.

CreateEntry(dòng, dòng, XarCompressionSettings)

Tạo một bản ghi duy nhất trong hồ sơ.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

Parameters

name string

Tên của entry.

source Stream

dòng đầu vào cho đầu vào.

compressionSettings XarCompressionSettings

Các cài đặt nén được sử dụng để thêm Aspose.Zip.Xar.XarEntry mục.

Returns

XarEntry

Xã hội nhập cảnh.

Examples

using (var archive = new XarArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.xar");
}

Exceptions

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

name’ is empty.

InvalidOperationException

Không thể sửa đổi file xar.

DeleteEntry(XarEntry)

Xóa sự xuất hiện đầu tiên của một bài đăng cụ thể từ danh sách bài đăng.

public XarArchive DeleteEntry(XarEntry entry)

Parameters

entry XarEntry

Đăng nhập để loại bỏ khỏi danh sách đăng nhập.

Returns

XarArchive

Xã hội nhập cảnh.

Examples

Dưới đây là cách bạn có thể xóa tất cả các bài đăng ngoại trừ bài đăng cuối cùng:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

Exceptions

ArgumentNullException

entry’ is null.

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.

ExtractToDirectory(String)

Loại bỏ tất cả các tập tin trong tập tin 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.

Examples

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

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

Exceptions

ArgumentNullException

Con đường là 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

con đường là một dây dài không, chỉ chứa không gian trắng, hoặc chứa một hoặc nhiều ký tự bất hợp pháp. bạn có thể truy vấn cho ký tự bất hợp pháp bằng cách sử dụng phương pháp System.IO.Path.GetInvalidPathChars. -or- con đường được đặt trước với, hoặc chứa, chỉ có một ký tự vỏ (:).

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.

InvalidDataException

Tài liệu đã bị phá hủy.

Save(Tính năng: XarSaveOptions)

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

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

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á.

saveOptions XarSaveOptions

Các tùy chọn để lưu xar lưu trữ với.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

Không thể sửa đổi file xar.

Save(Áp dụng, XarSaveOptions)

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

public void Save(Stream output, XarSaveOptions saveOptions = null)

Parameters

output Stream

Destination dòng

saveOptions XarSaveOptions

Các tùy chọn để lưu xar lưu trữ với.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

Không thể sửa đổi file xar.

 Tiếng Việt