Class ZArchive

Class ZArchive

Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)

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

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Arv

objectZArchive

Implementerar

IArchive, IDisposable, IArchiveFileEntry

Ärvda Medlemmar

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

Kommentarer

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

Konstruktörer

ZArchive()

Initierar en ny instans av Aspose.Zip.Z.ZArchive-klassen förberedd för komprimering.

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

Initierar en ny instans av Aspose.Zip.Z.ZArchive-klassen förberedd för dekomprimering.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parametrar

source Stream

Källan till arkivet.

loadOptions ZArchiveLoadOptions

Alternativen för att ladda arkivet med.

Kommentarer

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

Undantag

ArgumentException

source är inte sökbar.

ArgumentNullException

source är null.

ZArchive(string, ZArchiveLoadOptions)

Initierar en ny instans av Aspose.Zip.Z.ZArchive-klassen förberedd för dekomprimering.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parametrar

path string

Sökväg till källan för arkivet.

loadOptions ZArchiveLoadOptions

Alternativen för att ladda arkivet med.

Kommentarer

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

Undantag

ArgumentNullException

path är null.

SecurityException

Anroparen har inte nödvändiga behörigheter för att få åtkomst.

ArgumentException

path är tom, innehåller endast vita ytor eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till fil path nekas.

PathTooLongException

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

NotSupportedException

Fil på path innehåller ett kolon (:) i mitten av strängen.

FileNotFoundException

Fil hittades inte.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att vara på en icke-kartlagd enhet.

IOException

Fil är redan öppen.

Metoder

Dispose()

Utför applikationsdefinierade uppgifter kopplade till frigörande, släppande eller återställande av icke-hanterade resurser.

public void Dispose()

Dispose(bool)

Utför applikationsdefinierade uppgifter kopplade till frigörande, släppande eller återställande av icke-hanterade resurser.

protected virtual void Dispose(bool disposing)

Parametrar

disposing bool

Om hanterade resurser ska avyttras.

Extract(Stream)

Extraherar Z-arkiv till en ström.

public void Extract(Stream destination)

Parametrar

destination Stream

Ström för att lagra dekomprimerade data.

Exempel

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);
        }
    }
}

Undantag

InvalidDataException

Data kan inte dekomprimeras.

Extract(FileInfo)

Extraherar Z-arkiv till en fil.

public void Extract(FileInfo fileInfo)

Parametrar

fileInfo FileInfo

FileInfo för att lagra dekomprimerade data.

Exempel

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

Undantag

SecurityException

Anroparen har inte nödvändiga behörigheter för att öppna fileInfo.

ArgumentException

Filens sökväg är tom eller innehåller endast vita ytor.

FileNotFoundException

Fil hittades inte.

UnauthorizedAccessException

Sökväg till fil är skrivskyddad eller är en katalog.

ArgumentNullException

fileInfo är null.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att vara på en icke-kartlagd enhet.

IOException

Fil är redan öppen.

InvalidDataException

Data kan inte dekomprimeras.

Extract(string)

Extraherar Z-arkiv till en fil via sökväg.

public FileInfo Extract(string path)

Parametrar

path string

Sökväg till fil som kommer att lagra dekomprimerade data.

Returer

FileInfo

Info om den extraherade filen.

Exempel

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

Undantag

ArgumentNullException

path är null.

SecurityException

Anroparen har inte nödvändiga behörigheter för att få åtkomst.

ArgumentException

path är tom, innehåller endast vita ytor, eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till fil path nekas.

PathTooLongException

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

NotSupportedException

Fil på path innehåller ett kolon (:) i mitten av strängen.

InvalidDataException

Data kan inte dekomprimeras.

ExtractToDirectory(string)

Extraherar innehållet i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

Parametrar

destinationDirectory string

Sökväg till katalogen för att placera de extraherade filerna.

Kommentarer

Om katalogen inte finns kommer den att skapas.

Undantag

ArgumentNullException

destinationDirectory är null.

PathTooLongException

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

SecurityException

Anroparen har inte nödvändiga behörigheter för att få åtkomst till befintlig katalog.

NotSupportedException

Om katalogen inte finns, innehåller sökvägen ett kolon-tecken (:) som inte är en del av en enhetsbeteckning (“C:").

ArgumentException

destinationDirectory är en noll-längd sträng, innehåller endast vita ytor, eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken genom att använda metoden System.IO.Path.GetInvalidPathChars. -eller- sökvägen är prefixad med, eller innehåller, endast ett kolon-tecken (:).

IOException

Den angivna sökvägen är en fil. -eller- Det nätverksnamnet är inte känt.

Save(Stream, ZArchiveSaveOptions)

Sparar xz-arkiv till den angivna strömmen.

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

Parametrar

output Stream

Destinationström.

settings ZArchiveSaveOptions

Valfria inställningar för arkivkomposition.

Exempel

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

Kommentarer

output måste vara sökbar.

Undantag

ArgumentException

output stöder inte sökning.

ArgumentNullException

output är null.

Save(string, ZArchiveSaveOptions)

Sparar Z-arkivet till den angivna destinationsfilen.

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

Parametrar

destinationFileName string

+Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil, kommer den att skrivas över.

settings ZArchiveSaveOptions

Valfria inställningar för arkivkomposition.

Exempel

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

Undantag

ArgumentNullException

destinationFileName är null.

SecurityException

Anroparen har inte nödvändiga behörigheter för att få åtkomst.

ArgumentException

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

UnauthorizedAccessException

Åtkomst till fil destinationFileName nekas.

PathTooLongException

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

NotSupportedException

Fil på destinationFileName innehåller ett kolon (:) i mitten av strängen.

SetSource(Stream)

Sätter innehållet som ska komprimeras inom arkivet.

public void SetSource(Stream source)

Parametrar

source Stream

Indataström för arkivet.

Exempel

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

SetSource(FileInfo)

Sätter innehållet som ska komprimeras inom arkivet.

public void SetSource(FileInfo fileInfo)

Parametrar

fileInfo FileInfo

FileInfo som kommer att öppnas som indataström.

Exempel

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

Undantag

SecurityException

Anroparen har inte nödvändiga behörigheter för att öppna fileInfo.

ArgumentException

Filens sökväg är tom eller innehåller endast vita ytor.

FileNotFoundException

Fil hittades inte.

UnauthorizedAccessException

Sökväg till fil är skrivskyddad eller är en katalog.

ArgumentNullException

fileInfo är null.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, som att vara på en icke-kartlagd enhet.

IOException

Fil är redan öppen.

SetSource(string)

Sätter innehållet som ska komprimeras inom arkivet.

public void SetSource(string sourcePath)

Parametrar

sourcePath string

Sökväg till fil som kommer att öppnas som indataström.

Exempel

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

Undantag

ArgumentNullException

sourcePath är null eller tom sträng.

SecurityException

Anroparen har inte nödvändiga behörigheter för att få åtkomst till en resurs.

ArgumentException

sourcePath är tom, innehåller endast vita ytor, eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till fil sourcePath nekas.

PathTooLongException

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

NotSupportedException

Fil på sourcePath innehåller ett kolon (:) i mitten av strängen.

 Svenska