Class XzArchive

Class XzArchive

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

Denna klass representerar xz arkivfilen. Använd den för att komponera och extrahera xz arkiv.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object XzArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Arvsmedlemmar

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

Constructors

XzArchive(XzArchiveSettings)

Initialiserar en ny instans av Aspose.Zip.Xz.XzArchivklassen och komponerar arkivet i xz-format.

public XzArchive(XzArchiveSettings settings = null)

Parameters

settings XzArchiveSettings

Set av specifika xz arkiv inställningar: ordbokstorlek, blockstorlek, kontroll typ.

XzArchive(Stream)

Initialiserar en ny instans av Aspose.Zip.Xz.XzArchive klass förberedd för dekomprimering.

public XzArchive(Stream source)

Parameters

source Stream

Källan till arkivet.

Remarks

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

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

XzArchive(Sträng)

Initialiserar en ny instans av Aspose.Zip.Xz.XzArchive klass förberedd för dekomprimering.

public XzArchive(string path)

Parameters

path string

Vägen till källan till arkivet.

Remarks

Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Xz.XzArchive.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 xz arkiv till en ström.

public void Extract(Stream destination)

Parameters

destination Stream

Stream för lagring av dekomprimerade data.

Examples

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

Exceptions

InvalidOperationException

Arkivhuvud och tjänsteinformation läses inte.

Extract(FileInfo)

Extract xz arkiv till en fil.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo för lagring av dekomprimerade data.

Examples

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

Exceptions

InvalidOperationException

Arkivhuvud och tjänsteinformation läses inte.

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.

Extract(Sträng)

Extract xz 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

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

Examples

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

Exceptions

InvalidOperationException

Arkivhuvud och tjänsteinformation läses inte.

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.

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(Stream)

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

public void Save(Stream output)

Parameters

output Stream

Destination strömmar.

Examples

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

Remarks

Måste vara sökbar.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Sträng)

Spara xz arkiv till den avsedd filen.

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

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

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

Exceptions

ArgumentException

Strömmen av källan är inte sökbar.

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

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

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

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

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