Class XzArchive
De naam: Aspose.Zip.Xz Verzameling: Aspose.Zip.dll (25.5.0)
Deze klasse vertegenwoordigt xz archiefbestand. Gebruik het om xz archieven te composeren en te extraheren.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Geëerbiede leden
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XzArchive(XzArchiveSettings)
Initialiseert een nieuwe instantie van de Aspose.Zip.Xz.XzArchive-klasse en maakt het archief in xz-formaat.
public XzArchive(XzArchiveSettings settings = null)
Parameters
settings
XzArchiveSettings
Set van specifieke xz archief instellingen: woordenboekgrootte, blokgrootte, check type.
XzArchive(Stream)
Initialiseert een nieuwe instantie van de Aspose.Zip.Xz.XzArchive-klasse voorbereid voor decompressie.
public XzArchive(Stream source)
Parameters
source
Stream
De bron van het archief.
Remarks
Zie Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) methode voor decompressie.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(String)
Initialiseert een nieuwe instantie van de Aspose.Zip.Xz.XzArchive-klasse voorbereid voor decompressie.
public XzArchive(string path)
Parameters
path
string
De weg naar de bron van het archief.
Remarks
Zie Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) methode voor decompressie.
Exceptions
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.
Het bestand op path’ bevat een kolom (:) in het midden van de string.
Het bestand is niet gevonden.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
Methods
Dispose()
Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.
public void Dispose()
Dispose(Bool)
Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Of de beheerde middelen moeten worden afgebroken.
Extract(Stream)
Extract xz archief naar een stroom.
public void Extract(Stream destination)
Parameters
destination
Stream
Stream voor het opslaan van gedecomprimeerde gegevens.
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
Archiefhoofden en serviceinformatie werden niet gelezen.
Extract(FileInfo)
Extract xz archief naar een bestand.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo voor het opslaan van gedecomprimeerde gegevens.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Archiefhoofden en serviceinformatie werden niet gelezen.
De oproeker heeft niet de vereiste toestemming om de fileInfo’s te openen.
De bestandpad is leeg of bevat alleen witte ruimtes.
Het bestand is niet gevonden.
De weg naar het bestand is alleen te lezen of is een directory.
fileInfo’ is null.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
Extract(String)
Extract xz archief naar een bestand per pad.
public FileInfo Extract(string path)
Parameters
path
string
Path to file die de gedecomprimeerde gegevens zal opslaan.
Returns
System.IO.FileInfo instantie met geïntroduceerde gegevens.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
Archiefhoofden en serviceinformatie werden niet gelezen.
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.
Het bestand op path’ bevat een kolom (:) in het midden van de string.
Het bestand is niet gevonden.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
ExtractToDirectory(String)
Verwijder de inhoud van het archief naar het verstrekte directory.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
De route naar het directory om de geïntroduceerde bestanden in te plaatsen.
Remarks
Als de directory niet bestaat, wordt deze gemaakt.
Exceptions
destinationDirectory’ is null.
De aangegeven pad, bestandnaam of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens en bestandnamen moeten minder dan 260 tekens zijn.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen tot de bestaande directory.
Als de directory niet bestaat, bevat de route een colon karakter (:) dat niet deel uitmaakt van een drive label (“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 (:).
De door de route aangegeven directory is een bestand. -or- De netwerknaam is niet bekend.
Save(Stream)
Save xz archief naar de geleverde stroom.
public void Save(Stream output)
Parameters
output
Stream
De bestemming stroom.
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Remarks
Het moet zoektbaar zijn.
Exceptions
output’ does not support seeking.
output’ is null.
Save(String)
Save xz archief naar de bestandbestand die wordt verstrekt.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Exceptions
destinationFileName’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De destinationFileName’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand destinationFileName’ wordt geweigerd.
De aangegeven destinationFileName’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.
Het bestand bij destinationFileName’ bevat een kolom (:) in het midden van de string.
SetSource(Stream)
Stel de inhoud in om in het archief te worden gecomprimeerd.
public void SetSource(Stream source)
Parameters
source
Stream
De ingangstromen voor het archief.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
De bron’ stroom is niet te zoeken.
SetSource(FileInfo)
Stel de inhoud in om in het archief te worden gecomprimeerd.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo, die zal worden geopend als input stream.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Exceptions
De oproeker heeft niet de vereiste toestemming om de fileInfo’s te openen.
De bestandpad is leeg of bevat alleen witte ruimtes.
Het bestand is niet gevonden.
De weg naar het bestand is alleen te lezen of is een directory.
fileInfo’ is null.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
SetSource(String)
Stel de inhoud in om in het archief te worden gecomprimeerd.
public void SetSource(string sourcePath)
Parameters
sourcePath
string
Path to file die zal worden geopend als input stream.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De sourcePath’ is leeg, bevat alleen witte ruimtes, of bevat ongeldig tekens.
De toegang tot het bestand sourcePath’ wordt geweigerd.
De aangegeven sourcePath’, bestandnaam, of beide overschrijden de systeemdefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandnamen moeten minder dan 260 tekens zijn.
Het bestand bij sourcePath’ bevat een kolom (:) in het midden van de string.