Class ZArchive

Class ZArchive

Navne til: Aspose.Zip.Z Sammensætning: Aspose.Zip.dll (25.5.0)

Denne klasse repræsenterer en Z (komprimeret) arkivfil. Brug det til at komponere eller udveksle Z arkiver.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

De arvede medlemmer

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/compression/z/

Constructors

arkiver()

Initialiserer en ny instans af den Aspose.Zip.Z.Archive klasse forberedt til komprimering.

public ZArchive()

arkiver(Strøm, ZArchiveLoadOptions)

Initialiserer en ny instans af den Aspose.Zip.Z.Archive klasse forberedt til dekompression.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

kilden til arkivet.

loadOptions ZArchiveLoadOptions

De muligheder for at oplade arkiver med.

Remarks

Se Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metode til dekomprimering.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

arkiver(String, ZArchiveLoadOptions)

Initialiserer en ny instans af den Aspose.Zip.Z.Archive klasse forberedt til dekompression.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Vejen til kilden til arkivet.

loadOptions ZArchiveLoadOptions

De muligheder for at oplade arkiver med.

Remarks

Se Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metode til dekomprimering.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

FileNotFoundException

Filen er ikke fundet.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

Methods

Dispose()

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

Dispose(Bool)

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Om de forvaltede ressourcer skal fjernes.

Extract(Stream)

Ekstrakt Z arkiver til en strøm.

public void Extract(Stream destination)

Parameters

destination Stream

Strøm til opbevaring af dekomprimerede 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 ikke dekomprimeres.

Extract(FileInfo)

Ekstrakt Z arkiver til en fil.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo til opbevaring af dekomprimerede data.

Examples

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

Exceptions

SecurityException

Ringeren har ikke den nødvendige tilladelse til at åbne fileInfo'.

ArgumentException

Filvejen er tom eller indeholder kun hvide rum.

FileNotFoundException

Filen er ikke fundet.

UnauthorizedAccessException

Vejen til filen er læst alene eller er en katalog.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

InvalidDataException

Data kan ikke dekomprimeres.

Extract(String)

Ekstrakt Z arkiver til en fil efter vej.

public FileInfo Extract(string path)

Parameters

path string

Vej til fil, der vil gemme dekomprimerede data.

Returns

FileInfo

Information om en udvundet 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

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

InvalidDataException

Data kan ikke dekomprimeres.

ExtractToDirectory(String)

Udveksler indholdet af arkivet til den leverede katalog.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Vejen til katalogen til at placere de udvundne filer i.

Remarks

Hvis katalogen ikke eksisterer, vil den blive oprettet.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.

SecurityException

Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.

NotSupportedException

Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“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, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.

Save(Strøm, ZArchiveSaveOptions)

Sparer xz arkiver til den leverede strøm.

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

Parameters

output Stream

Destinationstrøm.

settings ZArchiveSaveOptions

Optionelle indstillinger for 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åske skal det søges.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(String, ZArchiveSaveOptions)

Sparer Z-arkivet til den leverede destinationskode.

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

Parameters

destinationFileName string

+Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

settings ZArchiveSaveOptions

Optionelle indstillinger for arkivkomposition.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

Den destinationFileName’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn.

UnauthorizedAccessException

Tilgang til filen destinationFileName’ er nægtet.

PathTooLongException

Den angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Fil på destinationFileName’ indeholder en kolonne (:) i midten af ringen.

SetSource(Stream)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(Stream source)

Parameters

source Stream

Indtægtsstrøm for arkivet.

Examples

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

SetSource(FileInfo)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, som vil blive åbnet som inputstrøm.

Examples

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

Exceptions

SecurityException

Ringeren har ikke den nødvendige tilladelse til at åbne fileInfo'.

ArgumentException

Filvejen er tom eller indeholder kun hvide rum.

FileNotFoundException

Filen er ikke fundet.

UnauthorizedAccessException

Vejen til filen er læst alene eller er en katalog.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

SetSource(String)

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Vejen til filen, som vil blive åbnet som inputstrøm.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang til en ressource.

ArgumentException

code class=“paramref”>sourcePath’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen sourcePath’ er nægtet.

PathTooLongException

Den angivne sourcePath’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på sourcePath’ indeholder en kolonne (:) i midten af ringen.

 Dansk