Class XzArchive

source är inte sökbar.

source är null.

XzArchive(string)

Initierar en ny instans av Aspose.Zip.Xz.XzArchive-klassen för avkomprimering.

public XzArchive(string path)

Parametrar

path string

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

Kommentarer

Denna konstruktor avkomprimerar inte. Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream)-metoden för avkomprimering.

Undantag

path är null.

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

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

Åtkomst till filen path är nekad.

Den angivna path, filnamnet 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.

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

Filen hittades inte.

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

InvalidOperationException

Filen är redan öppen.

Metoder

Dispose()

Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.

public void Dispose()

Dispose(bool)

Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.

protected virtual void Dispose(bool disposing)

Parametrar

disposing bool

Om hanterade resurser ska frigöras.

Extract(Stream)

Extraherar xz-arkiv till en ström.

public void Extract(Stream destination)

Parametrar

destination Stream

Ström för att lagra avkomprimerade data.

Exempel

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

Undantag

Arkivhuvuden och tjänsteinformation lästes inte.

Extract(FileInfo)

Extraherar xz-arkiv till en fil.

public void Extract(FileInfo fileInfo)

Parametrar

fileInfo FileInfo

FileInfo för att lagra avkomprimerade data.

Exempel

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

Undantag

InvalidOperationException

Arkivhuvuden och tjänsteinformation lästes inte.

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

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

Filen hittades inte.

Sökvägen till filen är skrivskyddad eller är en katalog.

fileInfo är null.

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

InvalidOperationException

Filen är redan öppen.

Extract(string)

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

public FileInfo Extract(string path)

Parametrar

path string

Sökväg till filen som kommer att lagra avkomprimerade data.

Returer

FileInfo

System.IO.FileInfo-instans som innehåller extraherade data.

Exempel

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

Undantag

Arkivhuvuden och tjänsteinformation lästes inte.

path är null.

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

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

Åtkomst till filen path är nekad.

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

Filen hittades inte.

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

Filen är redan öppen.

ExtractToDirectory(string)

Extraherar innehållet i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

Parametrar

destinationDirectory string

Sökvägen 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, filnamnet 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 den nödvändiga behörigheten för att få åtkomst till den befintliga katalogen.

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

destinationDirectory är en sträng med noll längd, innehåller endast vita tecken eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp av metoden System.IO.Path.GetInvalidPathChars. -eller- sökvägen är förprefixed med, eller innehåller, endast ett kolontecken (:).

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

Save(Stream)

Sparar xz-arkivet till den angivna strömmen.

public void Save(Stream output)

Parametrar

output Stream

Destinationström.

Exempel

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

Kommentarer

output måste vara sökbar.

Undantag

output stöder inte sökning.

output är null.

Save(string)

Sparar xz-arkivet till den angivna destinationsfilen.

public void Save(string destinationFileName)

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.

Exempel

using (var archive = new XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.xz");
}

Undantag

destinationFileName är null.

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

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

Åtkomst till filen destinationFileName är nekad.

Den angivna destinationFileName, filnamnet 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.

Filen 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 XzArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.xz");
}

Undantag

Strömmen source är icke-sökbar.

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 XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.xz");
}

Undantag

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

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

Filen hittades inte.

Sökvägen till filen är skrivskyddad eller är en katalog.

fileInfo är null.

Den angivna sökvägen är ogiltig, som att den ligger på en icke-mappad enhet.

Filen ä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 filen som kommer att öppnas som indataström.

Exempel

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

Undantag

sourcePath är null.

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

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

Åtkomst till filen sourcePath är nekad.

Den angivna sourcePath, filnamnet 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.