Class ZArchive

Class ZArchive

Namn på plats: Aspose.Zip.Z Sammanfattning: Aspose.Zip.dll (25.5.0)

Denna klass representerar en Z (komprimerad) arkivfil. Använd den för att komponera eller extrahera Z arkiv.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Arvsmedlemmar

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

Remarks

Se https://docs.fileformat.com/kompression/z/

Constructors

arkiv()

Initialiserar en ny instans av Aspose.Zip.Z.Archive-klassen förberedd för komprimering.

public ZArchive()

arkiv(Ström, ZArchiveLoadOptions)

Initialiserar en ny instans av Aspose.Zip.Z.Archive-klassen förberedd för dekomprimering.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

Källan till arkivet.

loadOptions ZArchiveLoadOptions

Alternativ för att ladda arkiv med.

Remarks

Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metod för dekomprimering.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

arkiv(Sträng, ZArchiveLoadOptions)

Initialiserar en ny instans av Aspose.Zip.Z.Archive-klassen förberedd för dekomprimering.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Vägen till källan till arkivet.

loadOptions ZArchiveLoadOptions

Alternativ för att ladda arkiv med.

Remarks

Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metod för dekomprimering.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

FileNotFoundException

Filen hittades inte.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

IOException

Filen är redan öppen.

Methods

Dispose()

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

public void Dispose()

Dispose(Bool)

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Oavsett om de förvaltade resurserna ska utplånas.

Extract(Stream)

Extract Z arkiv till en ström.

public void Extract(Stream destination)

Parameters

destination Stream

Stream för lagring av dekomprimerade data.

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

Data kan inte dekomprimeras.

Extract(FileInfo)

Extract Z arkiv till en fil.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo för lagring av dekomprimerade data.

Examples

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

Exceptions

SecurityException

Ringaren har inte tillståndet att öppna fileInfo'.

ArgumentException

Filvägen är tom eller innehåller endast vita utrymmen.

FileNotFoundException

Filen hittades inte.

UnauthorizedAccessException

Vägen till filen är läsbart eller är en katalog.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

IOException

Filen är redan öppen.

InvalidDataException

Data kan inte dekomprimeras.

Extract(Sträng)

Extract Z arkiv till en fil per väg.

public FileInfo Extract(string path)

Parameters

path string

Vägen till filen som kommer att lagra dekomprimerade data.

Returns

FileInfo

Information om en extraherad fil.

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

Sökanden har inte behörig tillstånd att komma åt.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

InvalidDataException

Data kan inte dekomprimeras.

ExtractToDirectory(Sträng)

Extraherar innehållet i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Vägen till katalogen för att placera de extraherade filerna i.

Remarks

Om katalogen inte existerar kommer den att skapas.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägarna vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.

SecurityException

Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.

NotSupportedException

Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“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

Den katalog som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.

Save(Ström, ZArchiveSaveOptions)

Spara xz arkiv till den tillhandahållna strömmen.

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

Parameters

output Stream

Destination strömmar.

settings ZArchiveSaveOptions

Optionella inställningar för arkivkomposition.

Examples

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

Remarks

Måste vara sökbar.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(String, ZArchiveSaveOptions)

Spara Z-arkiv till den angivna beställningsfilen.

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

Parameters

destinationFileName string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

settings ZArchiveSaveOptions

Optionella inställningar för arkivkomposition.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt.

ArgumentException

destinationFileName’ är tom, innehåller endast vita utrymmen, eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Tillgång till filen destinationFileName’ vägras.

PathTooLongException

Den angivna destinationFileName’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen i destinationFileName’ innehåller en kolumn (:) i mitten av raden.

SetSource(Stream)

Ställ in innehållet för att komprimeras inom arkivet.

public void SetSource(Stream source)

Parameters

source Stream

Inträdesflöde för arkivet.

Examples

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

SetSource(FileInfo)

Ställ in innehållet för att komprimeras inom arkivet.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo som öppnas som input stream.

Examples

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

Exceptions

SecurityException

Ringaren har inte tillståndet att öppna fileInfo'.

ArgumentException

Filvägen är tom eller innehåller endast vita utrymmen.

FileNotFoundException

Filen hittades inte.

UnauthorizedAccessException

Vägen till filen är läsbart eller är en katalog.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

IOException

Filen är redan öppen.

SetSource(Sträng)

Ställ in innehållet för att komprimeras inom arkivet.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Vägen till filen som öppnas som input stream.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Sökanden har inte behörig behörighet att få tillgång till en resurs.

ArgumentException

sourcePath’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen sourcePath’ vägras.

PathTooLongException

Den angivna sourcePath’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen i sourcePath’ innehåller en kolumn (:) i mitten av raden.

 Svenska