Class UueArchive

Class UueArchive

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

Цей клас представляє uuencoded файл.

public class UueArchive : IArchive, IDisposable, IArchiveFileEntry

Спадкування

objectUueArchive

Реалізує

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 для розпакування.

Виключення

ArgumentNullException

path є null.

SecurityException

Викликач не має необхідних дозволів для доступу.

ArgumentException

path є пустим, містить лише пробіли або містить недопустимі символи.

UnauthorizedAccessException

Доступ до файлу path заборонений.

PathTooLongException

Вказаний path, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл за path містить двокрапку (:) посередині рядка.

Властивості

Name

Ім’я оригінального файлу.

public string Name { get; }

Значення властивості

string

Методи

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

Виключення

ArgumentException

destination не підтримує запис.

Extract(string)

Витягує архів у файл за шляхом.

public FileInfo Extract(string path)

Параметри

path string

Шлях до файлу призначення. Якщо файл вже існує, він буде перезаписаний.

Повертає

FileInfo

Інформація про витягнутий файл.

Виключення

ArgumentNullException

path є null.

SecurityException

Викликач не має необхідних дозволів для доступу.

ArgumentException

path є пустим, містить лише пробіли або містить недопустимі символи.

UnauthorizedAccessException

Доступ до файлу path заборонений.

PathTooLongException

Вказаний path, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл за path містить двокрапку (:) посередині рядка.

FileNotFoundException

Файл не знайдено.

DirectoryNotFoundException

Вказаний шлях недійсний, наприклад, знаходиться на не змаркованому диску.

IOException

Файл вже відкритий.

ExtractToDirectory(string)

Витягує вміст архіву в надану директорію.

public void ExtractToDirectory(string destinationDirectory)

Параметри

destinationDirectory string

Шлях до директорії, в яку потрібно помістити витягнуті файли.

Зауваження

Якщо директорії не існує, вона буде створена.

Виключення

ArgumentNullException

destinationDirectory є null.

PathTooLongException

Вказаний шлях, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

SecurityException

Викликач не має необхідних дозволів для доступу до існуючої директорії.

NotSupportedException

Якщо директорія не існує, шлях містить символ двокрапки (:) який не є частиною мітки диска (“C:").

ArgumentException

destinationDirectory є рядком нульової довжини, містить лише пробіли або містить один або кілька недопустимих символів. Ви можете запитати недопустимі символи, використовуючи метод System.IO.Path.GetInvalidPathChars. -або- шлях має префікс, або містить, лише символ двокрапки (:).

IOException

Директорія, вказана за шляхом, є файлом. -або- Ім’я мережі невідоме.

Open()

Відкриває архів для декодування і надає потік з вмістом архіву.

public Stream Open()

Повертає

Stream

Потік, що представляє вміст архіву.

Приклади

Використання: 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 повинен бути записуваним.

Виключення

InvalidOperationException

Джерело даних для архіву не було надано.

ArgumentException

outputStream не є записуваним.

UnauthorizedAccessException

Джерело файлу є тільки для читання або є директорією.

DirectoryNotFoundException

Вказаний шлях джерела файлу недійсний, наприклад, знаходиться на не змаркованому диску.

IOException

Джерело файлу вже відкрите.

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

Виключення

ArgumentNullException

destinationFileName є null.

SecurityException

Викликач не має необхідних дозволів для доступу.

ArgumentException

destinationFileName є пустим, містить лише пробіли або містить недопустимі символи.

UnauthorizedAccessException

Доступ до файлу destinationFileName заборонений.

PathTooLongException

Вказане destinationFileName, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл за 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");
}

Виключення

ArgumentNullException

path є null.

SecurityException

Викликач не має необхідних дозволів для доступу.

ArgumentException

path є пустим, містить лише пробіли або містить недопустимі символи.

UnauthorizedAccessException

Доступ до файлу path заборонений.

PathTooLongException

Вказане path, ім’я файлу або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл за path містить двокрапку (:) посередині рядка.

 Українська