Class ZArchive

source är inte sökbar.

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

path är null.

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

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

Åtkomst till fil path nekas.

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.

DirectoryNotFoundException

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

FileNotFoundException

Fil hittades inte.

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

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

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

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

FileNotFoundException

Fil hittades inte.

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

DirectoryNotFoundException

fileInfo är null.

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

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

path är null.

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

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

Åtkomst till fil path nekas.

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

destinationDirectory är null.

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.

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

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

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 (:).

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

output stöder inte sökning.

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

destinationFileName är null.

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

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

Åtkomst till fil destinationFileName nekas.

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.

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

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

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

FileNotFoundException

Fil hittades inte.

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

DirectoryNotFoundException

fileInfo är null.

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

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

sourcePath är null eller tom sträng.

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

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

Åtkomst till fil sourcePath nekas.

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.