Class ZArchive

Class ZArchive

Pôvodný názov: Aspose.Zip.Z Zhromaždenie: Aspose.Zip.dll (25.5.0)

Táto trieda predstavuje Z (kompresný) archívový súbor. Použite ho na zloženie alebo extrahovanie Z archívov.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Z dedičných členov

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

Remarks

Zobraziť https://docs.fileformat.com/compression/z/

Constructors

Archív()

Iniciuje novú inštanciu triedy Aspose.Zip.Z.Archive pripravenú na kompresie.

public ZArchive()

Archív(Stream, ZArchiveLoadOptions)

Iniciuje novú inštanciu triedy Aspose.Zip.Z.Archive pripravenú na dekompresiu.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

zdrojom archívu.

loadOptions ZArchiveLoadOptions

Možnosti načítania archívov s.

Remarks

Tento konštruktor nie je dekompresívny. pozri Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metóda dekompresívy.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Archív(Príslušenstvo, ZArchiveLoadOptions)

Iniciuje novú inštanciu triedy Aspose.Zip.Z.Archive pripravenú na dekompresiu.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Cesta k zdroju archívov.

loadOptions ZArchiveLoadOptions

Možnosti načítania archívov s.

Remarks

Tento konštruktor nie je dekompresívny. pozri Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metóda dekompresívy.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

NotSupportedException

Súbor na path’ obsahuje stĺpec (:) v strede riadku.

FileNotFoundException

Súbor sa nenašiel.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

IOException

Súbor je už otvorený.

Methods

Dispose()

Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.

public void Dispose()

Dispose(bool)

Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Mali by sa riadiť riadené zdroje.

Extract(Stream)

Extrakt Z archív do prúdu.

public void Extract(Stream destination)

Parameters

destination Stream

Stream na ukladanie dekompresovaných údajov.

Examples

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

Exceptions

InvalidDataException

Údaje sa nedajú dekomprimovať.

Extract(FileInfo)

Extrakt Z archív do súboru.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo na ukladanie dekompresovaných údajov.

Examples

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

Exceptions

SecurityException

Volávač nemá požadované povolenie na otvorenie fileInfo'.

ArgumentException

Stránka je prázdna alebo obsahuje iba biele priestory.

FileNotFoundException

Súbor sa nenašiel.

UnauthorizedAccessException

Cesta k súboru je čitateľná alebo je adresár.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

IOException

Súbor je už otvorený.

InvalidDataException

Údaje sa nedajú dekomprimovať.

Extract(Stretnutie)

Extrakt Z archív do súboru podľa trasy.

public FileInfo Extract(string path)

Parameters

path string

Cesta k súboru, ktorý ukladá dekompresované údaje.

Returns

FileInfo

Informácie o extrahovanom súbore.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

NotSupportedException

Súbor na path’ obsahuje stĺpec (:) v strede riadku.

InvalidDataException

Údaje sa nedajú dekomprimovať.

ExtractToDirectory(Stretnutie)

Obsah archívu extrahuje do poskytnutého katalógu.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Cesta do adresára umiestniť extrahované súbory do.

Remarks

Ak katalóg neexistuje, vytvorí sa.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Ustanovená trasa, názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows musia byť trasy menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

SecurityException

Návštevník nemá požadované povolenie na prístup k existujúcemu adresáru.

NotSupportedException

Ak adresár neexistuje, cesta obsahuje znak kolónu (:) ktorý nie je súčasťou označenia disku (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

Katalóg špecifikovaný cestou je súbor. -or- Názov siete nie je známy.

Save(Stream, ZArchiveSaveOptions)

Ušetrí xz archív na poskytnutý prúd.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

Cestovný prúd .

settings ZArchiveSaveOptions

Možné nastavenia pre archívnu kompozíciu.

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

Musí byť vyhľadateľná.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Záruka, ZArchiveSaveOptions)

Uloží Z archív do poskytnutého cieľového súboru.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

+Cesta k vytvoreniu archívu.Ak uvedený názov súboru odkazuje na existujúci súbor, bude prepisovaný.

settings ZArchiveSaveOptions

Možné nastavenia pre archívnu kompozíciu.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

destinationFileName’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru destinationFileName’ je zamietnutý.

PathTooLongException

Určená destinationFileName’, názov súboru, alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

NotSupportedException

Súbor v destinationFileName’ obsahuje stĺpec (:) v strede riadku.

SetSource(Stream)

Umiestnite obsah, ktorý bude komprimovaný v archíve.

public void SetSource(Stream source)

Parameters

source Stream

Vstupný prúd pre archív.

Examples

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

Umiestnite obsah, ktorý bude komprimovaný v archíve.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, ktorý sa otvorí ako vstupný prúd.

Examples

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

Exceptions

SecurityException

Volávač nemá požadované povolenie na otvorenie fileInfo'.

ArgumentException

Stránka je prázdna alebo obsahuje iba biele priestory.

FileNotFoundException

Súbor sa nenašiel.

UnauthorizedAccessException

Cesta k súboru je čitateľná alebo je adresár.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

IOException

Súbor je už otvorený.

SetSource(Stretnutie)

Umiestnite obsah, ktorý bude komprimovaný v archíve.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Cesta k súboru, ktorý sa otvorí ako vstupný prúd.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Zamestnanec nemá požadované povolenie na prístup k zdroju.

ArgumentException

sourcePath’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru sourcePath’ je zamietnutý.

PathTooLongException

Určená sourcePath’, názov súboru, alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

NotSupportedException

Súbor v sourcePath’ obsahuje stĺpec (:) v strede riadku.

 Slovenčina