Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Lớp này đại diện cho tệp lưu trữ tar. Sử dụng nó để tạo, trích xuất hoặc cập nhật các tệp lưu trữ tar.

public class TarArchive : IArchive, IDisposable

Kế thừa

objectTarArchive

Thực hiện

IArchive, IDisposable

Thành viên kế thừa

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Các hàm khởi tạo

TarArchive()

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Tar.TarArchive.

public TarArchive()

Ví dụ

Ví dụ sau đây cho thấy cách nén một tệp.

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

TarArchive(Stream)

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Archive và tạo danh sách các mục có thể được trích xuất từ tệp lưu trữ.

public TarArchive(Stream sourceStream)

Tham số

sourceStream Stream

Nguồn của tệp lưu trữ. Nó phải có thể tìm kiếm.

Ví dụ

Ví dụ sau đây cho thấy cách trích xuấ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");
}

Nhận xét

Hàm khởi tạo này không giải nén bất kỳ mục nào. Xem phương thức Aspose.Zip.Tar.TarEntry.Open để giải nén.

Ngoại lệ

InvalidDataException

sourceStream không có khả năng tìm kiếm.

TarArchive(string)

Khởi tạo một thể hiện mới của lớp Aspose.Zip.Tar.TarArchive và tạo danh sách các mục có thể được trích xuất từ tệp lưu trữ.

public TarArchive(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Ví dụ

Ví dụ sau đây cho thấy cách trích xuấ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");
}

Nhận xét

Hàm khởi tạo này không giải nén bất kỳ mục nào. Xem phương thức Aspose.Zip.Tar.TarEntry.Open để giải nén.

Ngoại lệ

ArgumentNullException

path là null.

SecurityException

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

ArgumentException

path trống, chỉ chứa khoảng trắng, hoặc chứa các ký tự không hợp lệ.

UnauthorizedAccessException

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

PathTooLongException

path, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống định nghĩa. Ví dụ, trên các nền tảng Windows, đường dẫn phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

NotSupportedException

Tệp tại path chứa dấu hai chấm (:) ở giữa chuỗi.

FileNotFoundException

Tệp không được tìm thấy.

DirectoryNotFoundException

Đường dẫn đã chỉ định không hợp lệ, chẳng hạn như đang ở trên một ổ đĩa không được ánh xạ.

IOException

Tệp đã mở.

Thuộc tính

Entries

Lấy danh sách các mục của loại Aspose.Zip.Tar.TarEntry cấu thành tệp lưu trữ.

public ReadOnlyCollection<tarentry> Entries { get; }

Giá trị thuộc tính

ReadOnlyCollection<TarEntry&gt;

Phương thức

CreateEntries(DirectoryInfo, bool)

Thêm vào tệp lưu trữ tất cả các tệp và thư mục đệ quy trong thư mục đã cho.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

Tham số

directory DirectoryInfo

Thư mục để nén.

includeRootDirectory bool

Chỉ định xem có bao gồm thư mục gốc hay không.

Trả về

TarArchive

Tệp lưu trữ với các mục đã được tạo.

Ví dụ

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(string, bool)

Thêm vào tệp lưu trữ tất cả các tệp và thư mục đệ quy trong thư mục đã cho.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Tham số

sourceDirectory string

Thư mục để nén.

includeRootDirectory bool

Chỉ định xem có bao gồm thư mục gốc hay không.

Trả về

TarArchive

Tệp lưu trữ với các mục đã được tạo.

Ví dụ

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

Ngoại lệ

ArgumentNullException

sourceDirectory là null.

SecurityException

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

ArgumentException

sourceDirectory chứa các ký tự không hợp lệ như “, <, >, hoặc |.

PathTooLongException

path, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống định nghĩa. Ví dụ, trên các nền tảng Windows, đường dẫn phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự. Đường dẫn, tên tệp, hoặc cả hai quá dài.

CreateEntry(string, Stream, FileSystemInfo)

Tạo một mục đơn trong tệp lưu trữ.

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

Tham số

name string

Tên của mục.

source Stream

Luồng đầu vào cho mục.

fileInfo FileSystemInfo

Siêu dữ liệu của tệp hoặc thư mục cần nén.

Trả về

TarEntry

Thể hiện mục Tar.

Ví dụ

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

Nhận xét

Tên mục chỉ được thiết lập trong tham số name. Tên tệp cung cấp trong tham số fileInfo không ảnh hưởng đến tên mục.

fileInfo có thể tham chiếu đến System.IO.DirectoryInfo nếu mục là thư mục.

Ngoại lệ

PathTooLongException

name quá dài cho tar theo tiêu chuẩn IEEE 1003.1-1998.

ArgumentException

Tên tệp, như một phần của name, vượt quá 100 ký tự.

CreateEntry(string, FileInfo, bool)

Tạo một mục đơn trong tệp lưu trữ.

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

Tham số

name string

Tên của mục.

fileInfo FileInfo

Siêu dữ liệu của tệp hoặc thư mục cần nén.

openImmediately bool

True nếu mở tệp ngay lập tức, ngược lại mở tệp khi lưu tệp lưu trữ.

Trả về

TarEntry

Thể hiện mục Tar.

Ví dụ

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

Nhận xét

Tên mục chỉ được thiết lập trong tham số name. Tên tệp cung cấp trong tham số fileInfo không ảnh hưởng đến tên mục.

fileInfo có thể tham chiếu đến System.IO.DirectoryInfo nếu mục là thư mục.

Nếu tệp được mở ngay lập tức với tham số openImmediately nó sẽ bị chặn cho đến khi tệp lưu trữ được giải phóng.

Ngoại lệ

PathTooLongException

name quá dài cho tar theo tiêu chuẩn IEEE 1003.1-1998.

ArgumentException

Tên tệp, như một phần của name, vượt quá 100 ký tự.

CreateEntry(string, string, bool)

Tạo một mục đơn trong tệp lưu trữ.

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

Tham số

name string

Tên của mục.

path string

Đường dẫn đến tệp cần nén.

openImmediately bool

True nếu mở tệp ngay lập tức, ngược lại mở tệp khi lưu tệp lưu trữ.

Trả về

TarEntry

Thể hiện mục Tar.

Ví dụ

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

Nhận xét

Tên mục chỉ được thiết lập trong tham số name. Tên tệp cung cấp trong tham số path không ảnh hưởng đến tên mục.

Nếu tệp được mở ngay lập tức với tham số openImmediately nó sẽ bị chặn cho đến khi tệp lưu trữ được giải phóng.

Ngoại lệ

ArgumentNullException

path là null.

SecurityException

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

ArgumentException

path trống, chỉ chứa khoảng trắng, hoặc chứa các ký tự không hợp lệ. - hoặc - Tên tệp, 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

path, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống định nghĩa. Ví dụ, trên các nền tảng Windows, đường dẫn phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự. - hoặc - name quá dài cho tar theo tiêu chuẩn IEEE 1003.1-1998.

NotSupportedException

Tệp tại path chứa dấu hai chấm (:) ở giữa chuỗi.

DeleteEntry(TarEntry)

Xóa lần xuất hiện đầu tiên của một mục cụ thể khỏi danh sách các mục.

public TarArchive DeleteEntry(TarEntry entry)

Tham số

entry TarEntry

Mục cần xóa khỏi danh sách các mục.

Trả về

TarArchive

Tệp lưu trữ với mục đã bị xóa.

Ví dụ

Dưới đây là cách bạn có thể xóa tất cả các mục ngoại trừ mục 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 mục khỏi danh sách các mục theo chỉ số.

public TarArchive DeleteEntry(int entryIndex)

Tham số

entryIndex int

Chỉ số bắt đầu từ 0 của mục cần xóa.

Trả về

TarArchive

Tệp lưu trữ với mục đã bị xóa.

Ví dụ

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

Ngoại lệ

ArgumentOutOfRangeException

entryIndex nhỏ hơn 0.-hoặc- entryIndex bằng hoặc lớn hơn Entries count.

Dispose()

Thực hiện các tác vụ do ứng dụng xác định liên quan đến việc giải phóng, phát hành hoặc đặt lại các tài nguyên không quản lý.

public void Dispose()

Dispose(bool)

Thực hiện các tác vụ do ứng dụng xác định liên quan đến việc giải phóng, phát hành hoặc đặt lại các tài nguyên không quản lý.

protected virtual void Dispose(bool disposing)

Tham số

disposing bool

Cho biết liệu các tài nguyên quản lý có nên được giải phóng hay không.

ExtractToDirectory(string)

Trích xuất tất cả các tệp trong tệp lưu trữ vào thư mục đã cung cấp.

public void ExtractToDirectory(string destinationDirectory)

Tham số

destinationDirectory string

Đường dẫn đến thư mục để đặt các tệp đã trích xuất vào.

Ví dụ

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

Nhận xét

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

Ngoại lệ

ArgumentNullException

path là null

PathTooLongException

path, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống định nghĩa. Ví dụ, trên các nền tảng Windows, đường dẫn 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ó quyền truy cập cần thiết vào thư mục hiện có.

NotSupportedException

Nếu thư mục không tồn tại, đường dẫn chứa một ký tự hai chấm (:) không phải là một phần của nhãn ổ đĩa (“C:").

ArgumentException

path là một chuỗi có độ dài bằng 0, chỉ chứa khoảng trắng, hoặc chứa một hoặc nhiều ký tự không hợp lệ. Bạn có thể truy vấn các ký tự không hợp lệ bằng cách sử dụng phương thức System.IO.Path.GetInvalidPathChars. -hoặc- path được tiền tố bằng, hoặc chỉ chứa, một ký tự hai chấm (:).

IOException

Thư mục được chỉ định bởi path là một tệp. -hoặc- Tên mạng không được biết đến.

FromGZip(Stream)

Trích xuất tệp gzip được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp gzip được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromGZip(Stream source)

Tham số

source Stream

Nguồn của tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Luồng giải nén GZip không có khả năng tìm kiếm theo bản chất của thuật toán nén. Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

Ngoại lệ

InvalidDataException

Tệp lưu trữ bị hỏng.

FromGZip(string)

Trích xuất tệp gzip được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp gzip được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromGZip(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Luồng giải nén GZip không có khả năng tìm kiếm theo bản chất của thuật toán nén. Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

Ngoại lệ

InvalidDataException

Tệp lưu trữ bị hỏng.

FromLZMA(Stream)

Trích xuất tệp LZMA được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp LZMA được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromLZMA(Stream source)

Tham số

source Stream

Nguồn của tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Luồng giải nén LZMA không có khả năng tìm kiếm theo bản chất của thuật toán nén. Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromLZMA(string)

Trích xuất tệp LZMA được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp LZMA được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromLZMA(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Luồng giải nén LZMA không có khả năng tìm kiếm theo bản chất của thuật toán nén. Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromLZip(Stream)

Trích xuất tệp lzip được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp lzip được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromLZip(Stream source)

Tham số

source Stream

Nguồn của tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Luồng giải nén lzip không có khả năng tìm kiếm theo bản chất của thuật toán nén. Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromLZip(string)

Trích xuất tệp lzip được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp lzip được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromLZip(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Luồng giải nén lzip không có khả năng tìm kiếm theo bản chất của thuật toán nén. Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromXz(Stream)

Trích xuất tệp xz được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp xz được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromXz(Stream source)

Tham số

source Stream

Nguồn của tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromXz(string)

Trích xuất tệp xz được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp xz được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromXz(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromZ(Stream)

Trích xuất tệp Z được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp Z được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromZ(Stream source)

Tham số

source Stream

Nguồn của tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromZ(string)

Trích xuất tệp Z được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp Z được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromZ(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Nhận xét

Tệp lưu trữ Tar cung cấp khả năng trích xuất bản ghi tùy ý, vì vậy nó phải hoạt động trên luồng có thể tìm kiếm bên trong.

FromZstandard(Stream)

Trích xuất tệp Zstandard được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp Zstandard được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromZstandard(Stream source)

Tham số

source Stream

Nguồn của tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Ngoại lệ

IOException

Luồng Zstandard bị hỏng hoặc không thể đọc.

InvalidDataException

Dữ liệu bị hỏng.

FromZstandard(string)

Trích xuất tệp Zstandard được cung cấp và tạo Aspose.Zip.Tar.TarArchive từ dữ liệu đã trích xuất.

Quan trọng: tệp Zstandard được giải nén hoàn toàn trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

public static TarArchive FromZstandard(string path)

Tham số

path string

Đường dẫn đến tệp lưu trữ.

Trả về

TarArchive

Một thể hiện của Aspose.Zip.Tar.TarArchive

Ngoại lệ

IOException

Luồng Zstandard bị hỏng hoặc không thể đọc.

InvalidDataException

Dữ liệu bị hỏng.

Save(Stream, TarFormat?)

Lưu tệp lưu trữ vào luồng đã cung cấp.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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

Nhận xét

output phải có thể ghi.

Ngoại lệ

ArgumentException

output không có khả năng ghi. - hoặc - output là cùng một luồng mà chúng ta trích xuất từ đó. - HOẶC - Không thể lưu tệp lưu trữ trong format do các hạn chế của định dạng.

Save(string, TarFormat?)

Lưu tệp lưu trữ vào tệp đích đã cung cấp.

public void Save(string destinationFileName, TarFormat? format = null)

Tham số

destinationFileName string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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

Nhận xét

Có thể lưu tệp lưu trữ vào cùng một đường dẫn mà nó đã được tải từ. Tuy nhiên, điều này không được khuyến nghị vì cách tiếp cận này sử dụng việc sao chép vào tệp tạm thời.

Ngoại lệ

ArgumentException

destinationFileName là một chuỗi có độ dài bằng 0, chỉ chứa khoảng trắng, hoặc chứa một hoặc nhiều ký tự không hợp lệ như được định nghĩa bởi System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName là null.

PathTooLongException

destinationFileName, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống định nghĩa. Ví dụ, trên các nền tảng Windows, đường dẫn phải nhỏ hơn 248 ký tự, và tên tệp phải nhỏ hơn 260 ký tự.

DirectoryNotFoundException

destinationFileName chỉ định một tệp không hợp lệ, (ví dụ, nó ở trên một ổ đĩa không được ánh xạ).

IOException

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

UnauthorizedAccessException

destinationFileName chỉ định một tệp chỉ đọc và quyền truy cập không phải là Đọc.-hoặc- đường dẫn chỉ định một thư mục.-hoặc- Người gọi không có quyền truy cập cần thiết.

NotSupportedException

destinationFileName ở định dạng không hợp lệ.

FileNotFoundException

Tệp không được tìm thấy.

SaveGzipped(Stream, TarFormat?)

Lưu tệp lưu trữ vào luồng với nén gzip.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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);
        }
    }
}

Nhận xét

output phải có thể ghi.

Ngoại lệ

ArgumentNullException

output là null.

ArgumentException

output không có khả năng ghi.

SaveGzipped(string, TarFormat?)

Lưu tệp lưu trữ vào tệp theo đường dẫn với nén gzip.

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

Tham số

path string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

Lưu tệp lưu trữ vào luồng với nén LZMA.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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);
        }
    }
}

Nhận xét

output phải có thể ghi.

Quan trọng: tệp lưu trữ tar được tạo ra sau đó nén trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

Ngoại lệ

ArgumentNullException

output là null.

ArgumentException

output không có khả năng ghi.

SaveLZMACompressed(string, TarFormat?)

Lưu tệp lưu trữ vào tệp theo đường dẫn với nén lzma.

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

Tham số

path string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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");
    }
}

Nhận xét

Quan trọng: tệp lưu trữ tar được tạo ra sau đó nén trong phương thức này, nội dung của nó được giữ lại bên trong. Cẩn thận với việc tiêu thụ bộ nhớ.

SaveLzipped(Stream, TarFormat?)

Lưu tệp lưu trữ vào luồng với nén lzip.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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);
        }
    }
}

Nhận xét

output phải có thể ghi.

Ngoại lệ

ArgumentNullException

output là null.

ArgumentException

output không có khả năng ghi.

SaveLzipped(string, TarFormat?)

Lưu tệp lưu trữ vào tệp theo đường dẫn với nén lzip.

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

Tham số

path string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Lưu tệp lưu trữ vào luồng với nén xz.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

settings XzArchiveSettings

Tập hợp các thiết lập cho tệp xz cụ thể: kích thước từ điển, kích thước khối, loại kiểm tra.

Ví dụ

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);
        }
    }
}

Nhận xét

output phải có thể ghi.

Ngoại lệ

ArgumentNullException

output là null.

ArgumentException

output không có khả năng ghi.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Lưu tệp lưu trữ vào tệp theo đường dẫn với nén xz.

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

Tham số

path string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

settings XzArchiveSettings

Tập hợp các thiết lập cho tệp xz cụ thể: kích thước từ điển, kích thước khối, loại kiểm tra.

Ví dụ

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");
    }
}

SaveZCompressed(Stream, TarFormat?)

Lưu tệp lưu trữ vào luồng với nén Z.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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);
        }
    }
}

Nhận xét

output phải có thể ghi.

Ngoại lệ

ArgumentNullException

output là null.

ArgumentException

output không có khả năng ghi.

SaveZCompressed(string, TarFormat?)

Lưu tệp lưu trữ vào tệp theo đường dẫn với nén Z.

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

Tham số

path string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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");
    }
}

SaveZstandard(Stream, TarFormat?)

Lưu tệp lưu trữ vào luồng với nén Zstandard.

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

Tham số

output Stream

Luồng đích.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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);
        }
    }
}

Nhận xét

output phải có thể ghi.

Ngoại lệ

ArgumentNullException

output là null.

ArgumentException

output không có khả năng ghi.

SaveZstandard(string, TarFormat?)

Lưu tệp lưu trữ vào tệp theo đường dẫn với nén Zstandard.

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

Tham số

path string

Đường dẫn của tệp lưu trữ sẽ được tạo. Nếu tên tệp chỉ định trỏ đến một tệp hiện có, nó sẽ bị ghi đè.

format TarFormat?

Định nghĩa định dạng tiêu đề tar. Giá trị null sẽ được coi là USTar khi có thể.

Ví dụ

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");
    }
}
 Tiếng Việt