Class XzArchive
Navne til: Aspose.Zip.Xz Sammensætning: Aspose.Zip.dll (25.5.0)
Denne klasse repræsenterer xz arkiv fil. Brug det til at komponere og udveksle xz arkiver.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
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()
Constructors
XzArchive(XzArchiveSettings)
Initialiserer en ny instans af Aspose.Zip.Xz.XzArchive klasse og komponerer arkivet i xz format.
public XzArchive(XzArchiveSettings settings = null)
Parameters
settings
XzArchiveSettings
Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.
XzArchive(Stream)
Initialiserer en ny instans af den Aspose.Zip.Xz.XzArchive klasse forberedt til dekomprimering.
public XzArchive(Stream source)
Parameters
source
Stream
kilden til arkivet.
Remarks
Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metode til dekomprimering.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(String)
Initialiserer en ny instans af den Aspose.Zip.Xz.XzArchive klasse forberedt til dekomprimering.
public XzArchive(string path)
Parameters
path
string
Vejen til kilden til arkivet.
Remarks
Se Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metode til dekomprimering.
Exceptions
path’ is null.
Den pågældende har ikke den nødvendige tilladelse til at få adgang.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
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.
Filen på path’ indeholder en kolonne (:) i midten af ringen.
Filen er ikke fundet.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
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)
Udveksler xz arkiver til en strøm.
public void Extract(Stream destination)
Parameters
destination
Stream
Strøm til opbevaring af dekomprimerede 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
Arkiverne og serviceoplysningerne blev ikke læst.
Extract(FileInfo)
Udveksler xz arkiver til en fil.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo til opbevaring af dekomprimerede data.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Arkiverne og serviceoplysningerne blev ikke læst.
Ringeren har ikke den nødvendige tilladelse til at åbne fileInfo'.
Filvejen er tom eller indeholder kun hvide rum.
Filen er ikke fundet.
Vejen til filen er læst alene eller er en katalog.
fileInfo’ is null.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er allerede åben.
Extract(String)
Udveksler xz arkiver til en fil ved vej.
public FileInfo Extract(string path)
Parameters
path
string
Vej til fil, der vil gemme dekomprimerede data.
Returns
System.IO.FileInfo instans, der indeholder udvundet data.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
Arkiverne og serviceoplysningerne blev ikke læst.
path’ is null.
Den pågældende har ikke den nødvendige tilladelse til at få adgang.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
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.
Filen på path’ indeholder en kolonne (:) i midten af ringen.
Filen er ikke fundet.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er allerede åben.
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
destinationDirectory’ is null.
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.
Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.
Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“C:”).
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 (:).
Den katalog, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.
Save(Stream)
Sparer xz arkiver til den leverede strøm.
public void Save(Stream output)
Parameters
output
Stream
Destinationstrøm.
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Remarks
Måske skal det søges.
Exceptions
output’ does not support seeking.
output’ is null.
Save(String)
Sparer xz-arkivet til den leverede destinationsfil.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Exceptions
destinationFileName’ is null.
Den pågældende har ikke den nødvendige tilladelse til at få adgang.
Den destinationFileName’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn.
Tilgang til filen destinationFileName’ er nægtet.
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.
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 XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
Den source’ strøm er uønsket.
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 XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Exceptions
Ringeren har ikke den nødvendige tilladelse til at åbne fileInfo'.
Filvejen er tom eller indeholder kun hvide rum.
Filen er ikke fundet.
Vejen til filen er læst alene eller er en katalog.
fileInfo’ is null.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
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 XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
Den pågældende har ikke den nødvendige tilladelse til at få adgang.
code class=“paramref”>sourcePath’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen sourcePath’ er nægtet.
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.
Filen på sourcePath’ indeholder en kolonne (:) i midten af ringen.