Class TarArchive

Class TarArchive

Tên không gian: Aspose.Zip.Tar 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ữ tar. Sử dụng nó để tạo, extract, hoặc cập nhật các tập tin Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

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

TarArchive()

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

public TarArchive()

Examples

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

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

TarArchive(Stream)

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

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

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

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 TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Nhà sản xuất này không loại bỏ bất kỳ nhập khẩu nào. Xem Aspose.Zip.Tar.TarEntry.Open method for unpacking.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(String)

Bắt đầu một trường hợp mới của lớp Aspose.Zip.Tar.tarArchive và tạo ra một danh sách nhập có thể được rút ra từ lưu trữ.

public TarArchive(string path)

Parameters

path string

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

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 TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Nhà sản xuất này không loại bỏ bất kỳ nhập khẩu nào. Xem Aspose.Zip.Tar.TarEntry.Open method for unpacking.

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.

Properties

Entries

Gets entries of Aspose.Zip.Tar.TarEntry type constituting the archive.

public ReadOnlyCollection<tarentry> Entries { get; }

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

ReadOnlyCollection < TarEntry >

Methods

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 TarArchive 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

TarArchive

Archive with các entries composed.

Examples

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

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 TarArchive 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

TarArchive

Archive with các entries composed.

Examples

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

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.

CreateEntry(dòng, Stream, FileSystemInfo)

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

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Parameters

name string

Tên của entry.

source Stream

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

fileInfo FileSystemInfo

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

Returns

TarEntry

Vị trí nhập cảnh.

Examples

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

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.

có thể tham khảo System.IO.DirectoryInfo nếu nhập là thư mục.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

Tên tệp, như một phần của name’, vượt quá 100 biểu tượng.

CreateEntry(Nhãn hiệu: FileInfo, Bool)

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

public TarEntry 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

TarEntry

Vị trí nhập cảnh.

Examples

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

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.

có thể tham khảo System.IO.DirectoryInfo nếu nhập là thư mục.

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

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

Tên tệp, như một phần của name’, vượt quá 100 biểu tượng.

CreateEntry(string, string, bool)

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

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Parameters

name string

Tên của entry.

path 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

TarEntry

Vị trí nhập cảnh.

Examples

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

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

path’ is null.

SecurityException

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

ArgumentException

path’ là trống, chỉ chứa không gian trắng, hoặc chứa các ký tự vô hiệu. - 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 path” 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 tar so với tiêu chuẩn IEEE 1003.1-1998.

NotSupportedException

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

DeleteEntry(TarEntry)

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 TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

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

Returns

TarArchive

Archive with entry đã bị xóa.

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 TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

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

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

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

Returns

TarArchive

Archive with entry đã bị xóa.

Examples

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

Exceptions

ArgumentOutOfRangeException

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

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 TarArchive("archive.tar")) 
{ 
   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à zero

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

Bạn có thể truy vấn cho các ký tự bất hợp pháp bằng cách sử dụng phương pháp System.IO.Path.GetInvalid PathChars. - hoặc - con đường được đặt trước với, hoặc chứa, chỉ có một nhân vật cột (:).

IOException

Danh mục được chỉ định theo con đường là một tệp. - hoặc - Tên mạng không được biết.

TừGZip(Stream)

Các chiết xuất được cung cấp gzip lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được thu thập.

Quan trọng: file gzip được lấy hoàn toàn trong phương pháp này, nội dung của nó được lưu trữ bên trong.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

Stream khai thác GZip không được tìm kiếm bởi bản chất của thuật toán nén.Tar lưu trữ cung cấp cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải vận hành dòng được tìm kiếm dưới mảnh vỡ.

Exceptions

InvalidDataException

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

TừGZip(String)

Các chiết xuất được cung cấp gzip lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được thu thập.

Quan trọng: file gzip được lấy hoàn toàn trong phương pháp này, nội dung của nó được lưu trữ bên trong.

public static TarArchive FromGZip(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

Stream khai thác GZip không được tìm kiếm bởi bản chất của thuật toán nén.Tar lưu trữ cung cấp cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải vận hành dòng được tìm kiếm dưới mảnh vỡ.

Exceptions

ArgumentNullException

path’ is null.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

InvalidDataException

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

Từ LZ4(String)

Các chiết xuất được cung cấp LZ4 lưu trữ và kết hợp Aspose.Zip.tar.TarArchive từ dữ liệu được thu thập.

Quan trọng: LZ4 lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromLZ4(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

LZ4 dòng chiết xuất không được tìm kiếm bởi bản chất của thuật toán nén. lưu trữ Tar cung cấp cơ hội để lấy ra bản ghi tự nguyện, vì vậy nó phải hoạt động dòng có thể tìm thấy dưới vỏ.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

EndOfStreamException

file quá ngắn.

InvalidDataException

Tài liệu có chữ ký sai.

Từ LZ4(Stream)

Các chiết xuất được cung cấp LZ4 lưu trữ và kết hợp Aspose.Zip.tar.TarArchive từ dữ liệu được thu thập.

Quan trọng: LZ4 lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

LZ4 dòng chiết xuất không được tìm kiếm bởi bản chất của thuật toán nén. lưu trữ Tar cung cấp cơ hội để lấy ra bản ghi tự nguyện, vì vậy nó phải hoạt động dòng có thể tìm thấy dưới vỏ.

Exceptions

ArgumentException

Không thể đọc từ source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

Nguồn " có chữ ký sai.

Từ LZMA(Stream)

Các chiết xuất được cung cấp bởi LZMA lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: LZMA lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

LZMA dòng khai thác không được tìm kiếm bởi bản chất của thuật toán nén. Tar lưu trữ cung cấp một cơ hội để khai thác bản ghi tự nguyện, vì vậy nó phải hoạt động dòng tìm kiếm dưới lỗ.

Exceptions

InvalidDataException

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

Từ LZMA(String)

Các chiết xuất được cung cấp bởi LZMA lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: LZMA lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromLZMA(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

LZMA dòng chiết xuất không được tìm kiếm bởi bản chất của thuật toán nén. Tar lưu trữ cung cấp một cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải hoạt động dòng truy tìm được dưới vỏ.

Exceptions

ArgumentNullException

path’ is null.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

từLZip(Stream)

Các chiết xuất được cung cấp bởi lzip lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: file lzip được lấy hoàn toàn trong phương pháp này, nội dung của nó được lưu trữ bên trong.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

dòng khai thác Lzip không được tìm kiếm bởi bản chất của thuật toán nén. lưu trữ Tar cung cấp cơ hội để khai thác bản ghi tự nguyện, vì vậy nó phải hoạt động dòng tìm kiếm dưới lỗ.

Exceptions

InvalidDataException

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

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

từLZip(String)

Các chiết xuất được cung cấp bởi lzip lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: file lzip được lấy hoàn toàn trong phương pháp này, nội dung của nó được lưu trữ bên trong.

public static TarArchive FromLZip(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

dòng khai thác Lzip không được tìm kiếm bởi bản chất của thuật toán nén. lưu trữ Tar cung cấp cơ hội để khai thác bản ghi tự nguyện, vì vậy nó phải hoạt động dòng tìm kiếm dưới lỗ.

Exceptions

ArgumentNullException

path’ is null.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

InvalidDataException

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

FromXz(Stream)

Các chiết xuất được cung cấp xz định dạng lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: xz lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

Tar lưu trữ cung cấp cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải vận hành dòng được tìm kiếm dưới mảnh vỡ.

FromXz(String)

Các chiết xuất được cung cấp xz định dạng lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: xz lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromXz(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

Tar lưu trữ cung cấp cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải vận hành dòng được tìm kiếm dưới mảnh vỡ.

Exceptions

ArgumentNullException

path’ is null.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

Từ Z(Stream)

Các chiết xuất cung cấp Z định dạng lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu thu được.

Quan trọng: Z lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

Tar lưu trữ cung cấp cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải vận hành dòng được tìm kiếm dưới mảnh vỡ.

Từ Z(String)

Các chiết xuất cung cấp Z định dạng lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu thu được.

Quan trọng: Z lưu trữ được lấy hoàn toàn trong phương pháp này, nội dung của nó được giữ lại bên trong.

public static TarArchive FromZ(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Remarks

Tar lưu trữ cung cấp cơ hội để thu thập bản ghi tự nguyện, vì vậy nó phải vận hành dòng được tìm kiếm dưới mảnh vỡ.

Exceptions

ArgumentNullException

path’ is null.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

FromZstandard(Stream)

Các chiết xuất được cung cấp bởi Zstandard lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: Tài liệu tiêu chuẩn được lấy hoàn toàn trong phương pháp này, nội dung của nó được lưu trữ bên trong.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Nguồn gốc của Archive.

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Stream tiêu chuẩn bị hư hỏng hoặc không thể đọc được.

InvalidDataException

Dữ liệu bị hư hỏng

FromZstandard(String)

Các chiết xuất được cung cấp bởi Zstandard lưu trữ và kết hợp Aspose.Zip.Tar.TarArchive từ dữ liệu được rút ra.

Quan trọng: Tài liệu tiêu chuẩn được lấy hoàn toàn trong phương pháp này, nội dung của nó được lưu trữ bên trong.

public static TarArchive FromZstandard(string path)

Parameters

path string

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

Returns

TarArchive

Một ví dụ về Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

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" là trong định dạng không hoạt động.

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

Stream tiêu chuẩn bị hư hỏng hoặc không thể đọc được.

InvalidDataException

Dữ liệu bị hư hỏng

Save(Stream hay TarFormat?)

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

public void Save(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Remarks

phải có thể viết.

Exceptions

ArgumentException

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

Save(Cung cấp, TarFormat ?)

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

public void Save(string destinationFileName, TarFormat? format = 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á.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

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

ArgumentException

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

ArgumentNullException

destinationFileName’ is null.

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

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

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.

SaveGzipped(Stream hay TarFormat?)

Tiết kiệm lưu trữ cho dòng với gzip compression.

public void SaveGzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

Remarks

phải có thể viết.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Cung cấp, TarFormat ?)

Tiết kiệm lưu trữ cho tệp theo con đường với gzip.

public void SaveGzipped(string path, TarFormat? format = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

SaveLZ4Nhạc Chuông(Stream hay TarFormat?)

Tiết kiệm lưu trữ cho dòng với LZ4 nén.

public void SaveLZ4Compressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz4"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZ4Compressed(result);
        }
    }
}

Remarks

phải có thể viết.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4Nhạc Chuông(Cung cấp, TarFormat ?)

Tiết kiệm lưu trữ cho tệp theo con đường với LZ4 nén.

public void SaveLZ4Compressed(string path, TarFormat? format = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZ4Compressed("result.tar.lz4");
    }
}

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

SaveLZMACdập tắt(Stream hay TarFormat?)

Tiết kiệm lưu trữ cho dòng với LZMA compression.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

Remarks

phải có thể viết.

Quan trọng: lưu trữ tar được thành lập sau đó được nén trong phương pháp này, nội dung của nó được lưu trữ nội bộ.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZMACdập tắt(Cung cấp, TarFormat ?)

Tiết kiệm lưu trữ cho tệp theo con đường với lzma compression.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

Remarks

Quan trọng: lưu trữ tar được thành lập sau đó được nén trong phương pháp này, nội dung của nó được lưu trữ nội bộ.

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Stream hay TarFormat?)

Tiết kiệm lưu trữ cho dòng với lzip compression.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

Remarks

phải có thể viết.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Cung cấp, TarFormat ?)

Tiết kiệm lưu trữ cho tệp theo con đường với lzip.

public void SaveLzipped(string path, TarFormat? format = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Tiết kiệm lưu trữ cho dòng với xz compression.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

settings XzArchiveSettings

Set of setting particular xz archive: kích thước từ điển, kích thước khối, kiểm tra kiểu.

Examples

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

Remarks

dòng phải có khả năng viết.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Thẻ, TarFormat?, XzArchiveSettings)

Tiết kiệm lưu trữ cho con đường theo con đường với xz nén.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

settings XzArchiveSettings

Set of setting particular xz archive: kích thước từ điển, kích thước khối, kiểm tra kiểu.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

SaveZCompressed(Stream hay TarFormat?)

Tiết kiệm lưu trữ cho dòng bằng cách nén Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

Remarks

phải có thể viết.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZCompressed(Cung cấp, TarFormat ?)

Tiết kiệm lưu trữ cho con đường theo con đường với nén Z.

public void SaveZCompressed(string path, TarFormat? format = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Stream hay TarFormat?)

Tiết kiệm lưu trữ cho dòng với Zstandard compression.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination dòng

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

Remarks

phải có thể viết.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Cung cấp, TarFormat ?)

Tiết kiệm lưu trữ cho tệp theo con đường với Zstandard compression.

public void SaveZstandard(string path, TarFormat? format = null)

Parameters

path string

Nếu tên tệp được chỉ định cho một tệp hiện có, nó sẽ được viết quá.

format TarFormat ?

Định dạng tiêu đề tar. giá trị zero sẽ được xử lý như USTar khi có thể.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}

Exceptions

UnauthorizedAccessException

Người gọi không có giấy phép yêu cầu. -or- path’ được chỉ định một tệp hoặc thư mục chỉ đọc.

ArgumentException

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

ArgumentNullException

path’ is null.

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

DirectoryNotFoundException

Hướng dẫn path" được chỉ định là vô hiệu, (ví dụ, nó là trên một ổ đĩa không được bản đồ).

NotSupportedException

path’ is in an invalid format.

 Tiếng Việt