Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Lớp này đại diện cho tệp được mã hóa uu.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
Kế thừa
Triển khai
IArchive, IDisposable, IArchiveFileEntry
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
UueArchive()
Khởi tạo một thể hiện mới của lớp Aspose.Zip.Uue.UueArchive được chuẩn bị để mã hóa.
public UueArchive()
Ví dụ
Ví dụ dưới đây cho thấy cách mã hóa tệp.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
UueArchive(Stream)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.Uue.UueArchive được chuẩn bị để giải mã.
public UueArchive(Stream sourceStream)
Tham số
sourceStream
Stream
Nguồn của kho lưu trữ.
Ví dụ
Mở một kho lưu trữ từ một luồng và trích xuất nó vào một MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);
Nhận xét
Bộ khởi tạo này không giải mã. Xem phương thức Aspose.Zip.Uue.UueArchive.Open để giải nén.
UueArchive(string)
Khởi tạo một thể hiện mới của lớp Aspose.Zip.Uue.UueArchive.
public UueArchive(string path)
Tham số
path
string
Đường dẫn đến tệp kho lưu trữ.
Ví dụ
Mở một kho lưu trữ từ tệp theo đường dẫn và giải mã nó vào một MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);
Nhận xét
Bộ khởi tạo này không giải nén. Xem phương thức Aspose.Zip.Uue.UueArchive.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
là rỗ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 xác định. Ví dụ, trên các nền tảng dựa trên 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 một dấu hai chấm (:) ở giữa chuỗi.
Thuộc tính
Name
Tên của tệp gốc.
public string Name { get; }
Giá trị thuộc tính
Phương thức
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, giải phóng hoặc đặt lại 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, giải phóng hoặc đặt lại tài nguyên không quản lý.
protected virtual void Dispose(bool disposing)
Tham số
disposing
bool
Liệu các tài nguyên quản lý có nên được giải phóng hay không.
Extract(Stream)
Trích xuất kho lưu trữ đến luồng đã cung cấp.
public void Extract(Stream destination)
Tham số
destination
Stream
Luồng đích. Phải có thể ghi.
Ví dụ
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}
Ngoại lệ
destination
không hỗ trợ ghi.
Extract(string)
Trích xuất kho lưu trữ đến tệp theo đường dẫn.
public FileInfo Extract(string path)
Tham số
path
string
Đường dẫn đến tệp đích. Nếu tệp đã tồn tại, nó sẽ bị ghi đè.
Trả về
Thông tin của tệp đã trích xuất.
Ngoại lệ
path
là null.
Người gọi không có quyền truy cập cần thiết.
path
là rỗ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 xác định. Ví dụ, trên các nền tảng dựa trên 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 một 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ư nằm trên một ổ đĩa không được ánh xạ.
Tệp đã mở.
ExtractToDirectory(string)
Trích xuất nội dung của kho 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.
Nhận xét
Nếu thư mục không tồn tại, nó sẽ được tạo.
Ngoại lệ
destinationDirectory
là null.
Đường dẫn đã chỉ định, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng dựa trên 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ự dấu hai chấm (:) không phải là một phần của nhãn ổ đĩa (“C:").
destinationDirectory
là một chuỗi có độ dài bằng không, 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- đường dẫn được tiền tố bằng hoặc chỉ chứa một ký tự dấu hai chấm (:).
Thư mục được chỉ định bởi đường dẫn là một tệp. -hoặc- Tên mạng không được biết.
Open()
Mở kho lưu trữ để giải mã và cung cấp một luồng với nội dung kho lưu trữ.
public Stream Open()
Trả về
Luồng đại diện cho nội dung của kho lưu trữ.
Ví dụ
Sử dụng:
Stream decompressed = archive.Open();
.NET 4.0 và cao hơn - sử dụng phương thức Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 và trước đó - sao chép byte thủ công:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Nhận xét
Đọc từ luồng để lấy nội dung gốc của tệp. Xem phần ví dụ.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Lưu kho lưu trữ vào luồng đã cung cấp.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)
Tham số
outputStream
Stream
Luồng đích.
saveOptions
UueSaveOptions
Tùy chọn cho việc lưu kho lưu trữ.
Ví dụ
Ghi dữ liệu nén vào luồng phản hồi http.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Nhận xét
outputStream
phải có thể ghi.
Ngoại lệ
Nguồn dữ liệu để được lưu trữ chưa được cung cấp.
outputStream
không thể ghi.
Nguồn tệp là chỉ đọc hoặc là một thư mục.
Đường dẫn nguồn tệp đã chỉ định không hợp lệ, chẳng hạn như nằm trên một ổ đĩa không được ánh xạ.
Nguồn tệp đã mở.
Save(string, UueSaveOptions)
Lưu kho lưu trữ vào tệp đích đã cung cấp.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)
Tham số
destinationFileName
string
Đường dẫn đến kho lưu trữ sẽ được tạo. Nếu tên tệp đã chỉ định trỏ đến một tệp đã tồn tại, nó sẽ bị ghi đè.
saveOptions
UueSaveOptions
Tùy chọn cho việc lưu kho lưu trữ.
Ví dụ
Ghi dữ liệu đã mã hóa vào tệp.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}
Ngoại lệ
destinationFileName
là null.
Người gọi không có quyền truy cập cần thiết.
destinationFileName
là rỗ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 destinationFileName
bị từ chối.
destinationFileName
, tên tệp, hoặc cả hai vượt quá độ dài tối đa do hệ thống xác định. Ví dụ, trên các nền tảng dựa trên 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 destinationFileName
chứa một dấu hai chấm (:) ở giữa chuỗi.
SetSource(Stream)
Đặt nội dung sẽ được mã hóa trong kho lưu trữ.
public void SetSource(Stream source)
Tham số
source
Stream
Luồng đầu vào cho kho lưu trữ.
Ví dụ
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}
SetSource(FileInfo)
Đặt nội dung sẽ được nén trong kho lưu trữ.
public void SetSource(FileInfo fileInfo)
Tham số
fileInfo
FileInfo
Tham chiếu đến một tệp sẽ được nén.
Ví dụ
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}
SetSource(string)
Đặt nội dung sẽ được mã hóa trong kho lưu trữ.
public void SetSource(string path)
Tham số
path
string
Đường dẫn đến tệp sẽ được mã hóa.
Ví dụ
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
Ngoại lệ
path
là null.
Người gọi không có quyền truy cập cần thiết.
path
là rỗ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 xác định. Ví dụ, trên các nền tảng dựa trên 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 một dấu hai chấm (:) ở giữa chuỗi.