Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
Этот класс представляет файл архива snappy. Используйте его для создания или извлечения архивов snappy.
public class SnappyArchive : 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()
Конструкторы
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) для распаковки.
Исключения
source
не является доступным для поиска.
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) для распаковки.
Исключения
path
равно null.
У вызывающего нет необходимых разрешений для доступа.
path
пустой, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path
запрещен.
Указанный path
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по path
содержит двоеточие (:) в середине строки.
Файл не найден.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
Методы
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);
}
}
}
Исключения
Заголовки архива и служебная информация не были прочитаны.
Ошибка в данных в заголовке или контрольной сумме.
Поток назначения равен null.
Поток назначения не поддерживает запись.
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"));
}
}
Исключения
Заголовки архива и служебная информация не были прочитаны.
У вызывающего нет необходимых разрешений для открытия fileInfo
.
Путь к файлу пустой или содержит только пробелы.
Файл не найден.
Путь к файлу является только для чтения или является директорией.
fileInfo
равно null.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
Extract(string)
Извлекает архив snappy в файл по пути.
public FileInfo Extract(string path)
Параметры
path
string
Путь к файлу, который будет хранить распакованные данные.
Возвращает
Экземпляр System.IO.FileInfo, содержащий извлеченные данные.
Примеры
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract("extracted.bin");
}
}
Исключения
Заголовки архива и служебная информация не были прочитаны.
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.
-или- путь начинается с, или содержит, только символ двоеточия (:).
Указанный по пути каталог является файлом. -или- Сетевое имя неизвестно.
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
должен поддерживать поиск.
Исключения
output
не поддерживает поиск.
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"));
}
Исключения
У вызывающего нет необходимых разрешений для открытия destination
.
Путь к файлу пустой или содержит только пробелы.
Файл не найден.
Путь к файлу является только для чтения или является директорией.
destination
равно null.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
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");
}
Исключения
destinationFileName
равно null.
У вызывающего нет необходимых разрешений для доступа.
destinationFileName
пустой, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу destinationFileName
запрещен.
Указанный destinationFileName
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по 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");
}
Исключения
Поток 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");
}
Исключения
У вызывающего нет необходимых разрешений для открытия fileInfo
.
Путь к файлу пустой или содержит только пробелы.
Файл не найден.
Путь к файлу является только для чтения или является директорией.
fileInfo
равно null.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
SetSource(string)
Устанавливает содержимое, которое будет сжиматься в архиве.
public void SetSource(string sourcePath)
Параметры
sourcePath
string
Путь к файлу, который будет открыт как входной поток.
Примеры
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snappy");
}
Исключения
sourcePath
равно null.
У вызывающего нет необходимых разрешений для доступа.
sourcePath
пустой, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу sourcePath
запрещен.
Указанный sourcePath
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по sourcePath
содержит двоеточие (:) в середине строки.