Class ZArchive
De naam: Aspose.Zip.Z Verzameling: Aspose.Zip.dll (25.5.0)
Deze klasse vertegenwoordigt een Z (compress) archiefbestand. Gebruik het om Z-bestanden te composeren of te extraheren.
public class ZArchive : 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()
Remarks
Zie https://docs.fileformat.com/compression/z/
Constructors
Archieven()
Initialiseert een nieuwe instantie van de Aspose.Zip.Z.Archive-klasse voorbereid voor compressie.
public ZArchive()
Archieven(Stream, ZArchiveLoadOptions)
Initialiseert een nieuwe instantie van de Aspose.Zip.Z.Archive-klasse voorbereid voor decompressie.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parameters
source
Stream
De bron van het archief.
loadOptions
ZArchiveLoadOptions
De opties om archief te laden met.
Remarks
Zie Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) methode voor decompressie.
Exceptions
source’ is not seekable.
source’ is null.
Archieven(String, ZArchiveLoadOptions)
Initialiseert een nieuwe instantie van de Aspose.Zip.Z.Archive-klasse voorbereid voor decompressie.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parameters
path
string
De weg naar de bron van het archief.
loadOptions
ZArchiveLoadOptions
De opties om archief te laden met.
Remarks
Zie Aspose.Zip.Z.ZArchive.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 Z archief naar een stroom.
public void Extract(Stream destination)
Parameters
destination
Stream
Stream voor het opslaan van gedecomprimeerde gegevens.
Examples
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);
}
}
}
Exceptions
De gegevens kunnen niet worden gedecomprimeerd.
Extract(FileInfo)
Extract Z archief naar een bestand.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo voor het opslaan van gedecomprimeerde gegevens.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
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.
De gegevens kunnen niet worden gedecomprimeerd.
Extract(String)
Extract Z archief naar een bestand per pad.
public FileInfo Extract(string path)
Parameters
path
string
Path to file die de gedecomprimeerde gegevens zal opslaan.
Returns
Informatie over een geïntroduceerd bestand.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
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.
De gegevens kunnen niet worden gedecomprimeerd.
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, ZArchiveSaveOptions)
Save xz archief naar de geleverde stroom.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parameters
output
Stream
De bestemming stroom.
settings
ZArchiveSaveOptions
Optionele instellingen voor archiefcompositie.
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Remarks
Het moet zoektbaar zijn.
Exceptions
output’ does not support seeking.
output’ is null.
Save(String, ZArchiveSaveOptions)
Z-archief opslaat naar de bestandbestand die wordt verstrekt.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
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.
settings
ZArchiveSaveOptions
Optionele instellingen voor archiefcompositie.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
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 ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
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 ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
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 ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Exceptions
sourcePath’ is null or empty string.
De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot een bron.
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.