Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Цей клас представляє uuencoded файл.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
Спадкування
Реалізує
IArchive, IDisposable, IArchiveFileEntry
Спадковані члени
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Конструктори
UueArchive()
Ініціалізує новий екземпляр класу Aspose.Zip.Uue.UueArchive, підготовлений для кодування.
public UueArchive()
Приклади
Наступний приклад показує, як uuencode файл.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
UueArchive(Stream)
Ініціалізує новий екземпляр класу Aspose.Zip.Uue.UueArchive, підготовлений для декодування.
public UueArchive(Stream sourceStream)
Параметри
sourceStream
Stream
Джерело архіву.
Приклади
Відкриває архів з потоку і витягує його в MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);
Зауваження
Цей конструктор не декодує. Дивіться метод Aspose.Zip.Uue.UueArchive.Open для розпакування.
UueArchive(string)
Ініціалізує новий екземпляр класу Aspose.Zip.Uue.UueArchive.
public UueArchive(string path)
Параметри
path
string
Шлях до файлу архіву.
Приклади
Відкриває архів з файлу за шляхом і декодує його в MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);
Зауваження
Цей конструктор не розпаковує. Дивіться метод Aspose.Zip.Uue.UueArchive.Open для розпакування.
Виключення
path
є null.
Викликач не має необхідних дозволів для доступу.
path
є пустим, містить лише пробіли або містить недопустимі символи.
Доступ до файлу path
заборонений.
Вказаний path
, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за path
містить двокрапку (:) посередині рядка.
Властивості
Name
Ім’я оригінального файлу.
public string Name { get; }
Значення властивості
Методи
Dispose()
Виконує завдання, визначені додатком, пов’язані з вивільненням, скиданням або звільненням некерованих ресурсів.
public void Dispose()
Dispose(bool)
Виконує завдання, визначені додатком, пов’язані з вивільненням, скиданням або звільненням некерованих ресурсів.
protected virtual void Dispose(bool disposing)
Параметри
disposing
bool
Чи повинні бути вивільнені керовані ресурси.
Extract(Stream)
Витягує архів у наданий потік.
public void Extract(Stream destination)
Параметри
destination
Stream
Потік призначення. Повинен бути записуваним.
Приклади
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}
Виключення
destination
не підтримує запис.
Extract(string)
Витягує архів у файл за шляхом.
public FileInfo Extract(string path)
Параметри
path
string
Шлях до файлу призначення. Якщо файл вже існує, він буде перезаписаний.
Повертає
Інформація про витягнутий файл.
Виключення
path
є null.
Викликач не має необхідних дозволів для доступу.
path
є пустим, містить лише пробіли або містить недопустимі символи.
Доступ до файлу path
заборонений.
Вказаний path
, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за path
містить двокрапку (:) посередині рядка.
Файл не знайдено.
Вказаний шлях недійсний, наприклад, знаходиться на не змаркованому диску.
Файл вже відкритий.
ExtractToDirectory(string)
Витягує вміст архіву в надану директорію.
public void ExtractToDirectory(string destinationDirectory)
Параметри
destinationDirectory
string
Шлях до директорії, в яку потрібно помістити витягнуті файли.
Зауваження
Якщо директорії не існує, вона буде створена.
Виключення
destinationDirectory
є null.
Вказаний шлях, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Викликач не має необхідних дозволів для доступу до існуючої директорії.
Якщо директорія не існує, шлях містить символ двокрапки (:) який не є частиною мітки диска (“C:").
destinationDirectory
є рядком нульової довжини, містить лише пробіли або містить один або кілька недопустимих символів. Ви можете запитати недопустимі символи, використовуючи метод System.IO.Path.GetInvalidPathChars.
-або- шлях має префікс, або містить, лише символ двокрапки (:).
Директорія, вказана за шляхом, є файлом. -або- Ім’я мережі невідоме.
Open()
Відкриває архів для декодування і надає потік з вмістом архіву.
public Stream Open()
Повертає
Потік, що представляє вміст архіву.
Приклади
Використання:
Stream decompressed = archive.Open();
.NET 4.0 і вище - використовуйте метод Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 і раніше - копіюйте байти вручну:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Зауваження
Читання з потоку для отримання оригінального вмісту файлу. Дивіться розділ прикладів.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Зберігає архів у наданий потік.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)
Параметри
outputStream
Stream
Потік призначення.
saveOptions
UueSaveOptions
Опції для збереження архіву.
Приклади
Записує стиснені дані в потік відповіді http.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Зауваження
outputStream
повинен бути записуваним.
Виключення
Джерело даних для архіву не було надано.
outputStream
не є записуваним.
Джерело файлу є тільки для читання або є директорією.
Вказаний шлях джерела файлу недійсний, наприклад, знаходиться на не змаркованому диску.
Джерело файлу вже відкрите.
Save(string, UueSaveOptions)
Зберігає архів у наданий файл призначення.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)
Параметри
destinationFileName
string
Шлях до архіву, який потрібно створити. Якщо вказане ім’я файлу вказує на існуючий файл, він буде перезаписаний.
saveOptions
UueSaveOptions
Опції для збереження архіву.
Приклади
Записує закодовані дані у файл.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}
Виключення
destinationFileName
є null.
Викликач не має необхідних дозволів для доступу.
destinationFileName
є пустим, містить лише пробіли або містить недопустимі символи.
Доступ до файлу destinationFileName
заборонений.
Вказане destinationFileName
, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за destinationFileName
містить двокрапку (:) посередині рядка.
SetSource(Stream)
Встановлює вміст, який потрібно закодувати в архіві.
public void SetSource(Stream source)
Параметри
source
Stream
Вхідний потік для архіву.
Приклади
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}
SetSource(FileInfo)
Встановлює вміст, який потрібно стиснути в архіві.
public void SetSource(FileInfo fileInfo)
Параметри
fileInfo
FileInfo
Посилання на файл, який потрібно стиснути.
Приклади
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}
SetSource(string)
Встановлює вміст, який потрібно закодувати в архіві.
public void SetSource(string path)
Параметри
path
string
Шлях до файлу, який потрібно закодувати.
Приклади
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
Виключення
path
є null.
Викликач не має необхідних дозволів для доступу.
path
є пустим, містить лише пробіли або містить недопустимі символи.
Доступ до файлу path
заборонений.
Вказане path
, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за path
містить двокрапку (:) посередині рядка.