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
містить двокрапку (:) посередині рядка.