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
Thực hiện
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ệ
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ệ
path
là null.
Người gọi không có quyền truy cập cần thiết.
path
trống, chỉ chứa khoảng trắng, hoặc chứa các ký tự không hợp lệ.
Truy cập vào tệp path
bị từ chối.
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ự.
Tệp tại path
chứa dấu hai chấm (:) ở giữa chuỗi.
Tệp không được tìm thấy.
Đườ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ạ.
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>
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ề
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ề
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ệ
sourceDirectory
là null.
Người gọi không có quyền truy cập cần thiết đến sourceDirectory
.
sourceDirectory
chứa các ký tự không hợp lệ như “, <, >, hoặc |.
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ề
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ệ
name
quá dài cho tar theo tiêu chuẩn IEEE 1003.1-1998.
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ề
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ệ
name
quá dài cho tar theo tiêu chuẩn IEEE 1003.1-1998.
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ề
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ệ
path
là null.
Người gọi không có quyền truy cập cần thiết.
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ự.
Truy cập vào tệp path
bị từ chối.
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.
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ề
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 > 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ề
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ệ
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ệ
path là null
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ười gọi không có quyền truy cập cần thiết vào thư mục hiện có.
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:").
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 (:).
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ề
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ệ
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ề
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ệ
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ề
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ề
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ề
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ề
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ề
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ề
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ề
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ề
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ề
Một thể hiện của Aspose.Zip.Tar.TarArchive
Ngoại lệ
Luồng Zstandard bị hỏng hoặc không thể đọc.
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ề
Một thể hiện của Aspose.Zip.Tar.TarArchive
Ngoại lệ
Luồng Zstandard bị hỏng hoặc không thể đọc.
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ệ
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ệ
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.
destinationFileName
là null.
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ự.
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ạ).
Đã xảy ra lỗi I/O trong khi mở tệp.
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.
destinationFileName
ở định dạng không hợp lệ.
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ệ
output
là null.
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.
Ngoại lệ
output
là null.
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ệ
output
là null.
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ệ
output
là null.
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ệ
output
là null.
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ệ
output
là null.
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");
}
}