Class SharArchive

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.

`Properties`

`Entries`

Gets entries of Aspose.Zip.Shar.SharEntry type constituting the archive.

public ReadOnlyCollection<sharentry> Entries { get; }

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

ReadOnlyCollection < SharEntry >

`Methods`

`CreateEntries(Lời bài hát: Bool)`

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 SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

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

`Returns`

Vị trí nhập cảnh.

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(sharFile);
    }
}

`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(Bảng tin tức, bool)`

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 SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

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

`Returns`

Vị trí nhập cảnh.

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(sharFile);
    }
}

`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(Nhãn hiệu: FileInfo, Bool)`

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

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`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ữ.

`Returns`

SharEntry

Vị trí nhập cảnh.

`Examples`

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

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

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

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`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ữ.

`Returns`

SharEntry

Vị trí nhập cảnh.

`Examples`

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

`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 để sắc nét.

NotSupportedException

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

`CreateEntry(Stream , Stream)`

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

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

Tên của entry.

source Stream

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

`Returns`

SharEntry

Vị trí nhập cảnh.

`Examples`

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

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(SharEntry)`

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 SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

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

`Returns`

Vị trí 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 SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(int)`

Xóa nhập từ danh sách nhập theo chỉ số.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Chỉ số dựa trên zero của nhập để loại bỏ.

`Returns`

ArgumentOutOfRangeException

Archive with entry đã bị xóa.

`Examples`

using (var archive = new SharArchive("two_files.shar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.shar");
}

`Exceptions`

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

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

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

`Save(String)`

Tiết kiệm lưu trữ đến một tập tin đí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 SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

`Remarks`

Nó có thể được lưu trữ một tập tin theo cùng một con đường như nó đã được tải về từ. tuy nhiên, điều này không được khuyến khích bởi vì phương pháp này sử dụng sao chép vào một tập tin tạm thời.

`Exceptions`

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

destinationFileName’ is null.

DirectoryNotFoundException

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

Mục định destinationFileName’ là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được vẽ).

UnauthorizedAccessException

Một lỗi I/O xảy ra trong khi mở tệp.

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

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

`Save(Stream)`

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

public void Save(Stream output)

`Parameters`

output Stream

Destination dòng

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

phải có thể viết.

`Exceptions`

output’ is null.