Class XarArchive

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`

path’ is null.

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

UnauthorizedAccessException

Đườ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.

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

DirectoryNotFoundException

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.

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

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`

sourceDirectory’ is null.

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

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

Đườ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.

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`

directory’ is null.

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

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`

name’ is null.

name’ is empty.

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`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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.

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`

name’ is null.

source’ is null.

name’ is empty.

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`

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`

Con đường là null

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

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:”).

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ỏ (:).

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`

destinationFileName’ is null.

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`

output’ is null.

output’Is not writable/readable or not seekable.