Class UueArchive

Class UueArchive

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

Этот класс представляет uuencoded файл.

public class UueArchive : IArchive, IDisposable, IArchiveFileEntry

Наследование

object ← UueArchive

Реализует

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 содержит двоеточие (:) посреди строки.

 Русский