Class SnappyArchive

Class SnappyArchive

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

Этот класс представляет файл архива snappy. Используйте его для создания или извлечения архивов snappy.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

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

objectSnappyArchive

Реализует

IArchive, IDisposable, IArchiveFileEntry

Унаследованные члены

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Конструкторы

SnappyArchive()

Инициализирует новый экземпляр класса Aspose.Zip.Snappy.SnappyArchive, подготовленный для сжатия.

public SnappyArchive()

Примеры

Следующий пример показывает, как сжать файл.

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snapy");
}

SnappyArchive(Stream)

Инициализирует новый экземпляр класса Aspose.Zip.Snappy.SnappyArchive, подготовленный для распаковки.

public SnappyArchive(Stream source)

Параметры

source Stream

Источник архива.

Замечания

Этот конструктор не распаковывает. Смотрите метод Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) для распаковки.

Исключения

ArgumentException

source не является доступным для поиска.

ArgumentNullException

source равно null.

SnappyArchive(string)

Инициализирует новый экземпляр класса Aspose.Zip.Snappy.SnappyArchive, подготовленный для распаковки.

public SnappyArchive(string path)

Параметры

path string

Путь к источнику архива.

Примеры

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

Замечания

Этот конструктор не распаковывает. Смотрите метод Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) для распаковки.

Исключения

ArgumentNullException

path равно null.

SecurityException

У вызывающего нет необходимых разрешений для доступа.

ArgumentException

path пустой, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу path запрещен.

PathTooLongException

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

NotSupportedException

Файл по path содержит двоеточие (:) в середине строки.

FileNotFoundException

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

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

Методы

Dispose()

Выполняет определенные приложением задачи, связанные с освобождением, высвобождением или сбросом неуправляемых ресурсов.

public void Dispose()

Dispose(bool)

Выполняет определенные приложением задачи, связанные с освобождением, высвобождением или сбросом неуправляемых ресурсов.

protected virtual void Dispose(bool disposing)

Параметры

disposing bool

Следует ли освобождать управляемые ресурсы.

Extract(Stream)

Извлекает архив snappy в поток.

public void Extract(Stream destination)

Параметры

destination Stream

Поток для хранения распакованных данных.

Примеры

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

Исключения

InvalidOperationException

Заголовки архива и служебная информация не были прочитаны.

InvalidDataException

Ошибка в данных в заголовке или контрольной сумме.

ArgumentNullException

Поток назначения равен null.

ArgumentException

Поток назначения не поддерживает запись.

Extract(FileInfo)

Извлекает архив snappy в файл.

public void Extract(FileInfo fileInfo)

Параметры

fileInfo FileInfo

FileInfo для хранения распакованных данных.

Примеры

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Исключения

InvalidOperationException

Заголовки архива и служебная информация не были прочитаны.

SecurityException

У вызывающего нет необходимых разрешений для открытия fileInfo.

ArgumentException

Путь к файлу пустой или содержит только пробелы.

FileNotFoundException

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

UnauthorizedAccessException

Путь к файлу является только для чтения или является директорией.

ArgumentNullException

fileInfo равно null.

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

Extract(string)

Извлекает архив snappy в файл по пути.

public FileInfo Extract(string path)

Параметры

path string

Путь к файлу, который будет хранить распакованные данные.

Возвращает

FileInfo

Экземпляр System.IO.FileInfo, содержащий извлеченные данные.

Примеры

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract("extracted.bin");
    }
}

Исключения

InvalidOperationException

Заголовки архива и служебная информация не были прочитаны.

ArgumentNullException

path равно null.

SecurityException

У вызывающего нет необходимых разрешений для доступа.

ArgumentException

path пустой, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу path запрещен.

PathTooLongException

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

NotSupportedException

Файл по path содержит двоеточие (:) в середине строки.

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

Указанный по пути каталог является файлом. -или- Сетевое имя неизвестно.

Save(Stream)

Сохраняет архив snappy в предоставленный поток.

public void Save(Stream output)

Параметры

output Stream

Поток назначения.

Примеры

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

Замечания

output должен поддерживать поиск.

Исключения

ArgumentException

output не поддерживает поиск.

ArgumentNullException

output равно null.

Save(FileInfo)

Сохраняет архив snappy в предоставленный файл назначения.

public void Save(FileInfo destination)

Параметры

destination FileInfo

FileInfo, который будет открыт как поток назначения.

Примеры

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.snappy"));
}

Исключения

SecurityException

У вызывающего нет необходимых разрешений для открытия destination.

ArgumentException

Путь к файлу пустой или содержит только пробелы.

FileNotFoundException

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

UnauthorizedAccessException

Путь к файлу является только для чтения или является директорией.

ArgumentNullException

destination равно null.

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

Save(string)

Сохраняет архив snappy в предоставленный файл назначения.

public void Save(string destinationFileName)

Параметры

destinationFileName string

Путь к архиву, который будет создан. Если указано имя файла, указывающее на существующий файл, он будет перезаписан.

Примеры

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.snappy");
}

Исключения

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 SnappyArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.snappy");
}

Исключения

ArgumentException

Поток source не поддерживает поиск.

SetSource(FileInfo)

Устанавливает содержимое, которое будет сжиматься в архиве.

public void SetSource(FileInfo fileInfo)

Параметры

fileInfo FileInfo

FileInfo, который будет открыт как входной поток.

Примеры

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.snappy");
}

Исключения

SecurityException

У вызывающего нет необходимых разрешений для открытия fileInfo.

ArgumentException

Путь к файлу пустой или содержит только пробелы.

FileNotFoundException

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

UnauthorizedAccessException

Путь к файлу является только для чтения или является директорией.

ArgumentNullException

fileInfo равно null.

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

SetSource(string)

Устанавливает содержимое, которое будет сжиматься в архиве.

public void SetSource(string sourcePath)

Параметры

sourcePath string

Путь к файлу, который будет открыт как входной поток.

Примеры

using (var archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

Исключения

ArgumentNullException

sourcePath равно null.

SecurityException

У вызывающего нет необходимых разрешений для доступа.

ArgumentException

sourcePath пустой, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу sourcePath запрещен.

PathTooLongException

Указанный sourcePath, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.

NotSupportedException

Файл по sourcePath содержит двоеточие (:) в середине строки.

 Русский