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

 Українська