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
Implements
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
sourceStream’ is null.
sourceStream’ is not seekable.
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.
Đườ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.
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ự.
Tệp ở path’ chứa một cột (:) ở giữa dòng.
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.
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
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
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
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
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.
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.
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
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
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 > 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ó.
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.
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.
Không thể sửa đổi file xar.