Class ZstandardArchive
De naam: Aspose.Zip.Zstandard Verzameling: Aspose.Zip.dll (25.5.0)
Deze klasse vertegenwoordigt een Zstandard archiefbestand. Gebruik het om Zstandard archieven te maken.
public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
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
ZstandardArchive()
Initialiseert een nieuwe instantie van de Aspose.Zip.Zstandard.ZstandardArchiefklasse voorbereid voor compressie.
public ZstandardArchive()Examples
Het volgende voorbeeld laat zien hoe u een bestand kunt compresseren.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(Stream, ZstandardLoadOptions)
Initialiseert een nieuwe instantie van de Aspose.Zip.Zstandard.ZstandardArchiefklasse voorbereid voor decompressie.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parameters
sourceStream Stream
De bron van het archief.
options ZstandardLoadOptions
De opties om archief te laden met.
Examples
Open een archief van een stroom en extraheren naar een
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Remarks
Zie Aspose.Zip.Zstandard.ZstandardArchive.Open methode voor decompressie.
ZstandardArchive(String, ZstandardLoadOptions)
Initialiseert een nieuwe instantie van de Aspose.Zip.Zstandard.ZstandardArchive klasse.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parameters
path string
De weg naar het archiefbestand.
options ZstandardLoadOptions
De opties om archief te laden met.
Examples
Open een archief van het bestand per pad en extraheren naar een
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Remarks
Zie Aspose.Zip.Zstandard.ZstandardArchive.Open 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.
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 het archief naar de verstrekte stroom.
public void Extract(Stream destination)Parameters
destination Stream
Destination stream. moet geschreven zijn.
Examples
using (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(String)
Extract het archief naar het bestand per pad.
public FileInfo Extract(string path)Parameters
path string
De route naar bestand bestemming.Als het bestand al bestaat, zal het worden overgeschreven.
Returns
Informatie over een geïntroduceerd bestand.
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.
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.
Open()
Open het archief voor extractie en geeft een stroom met archiefinhoud.
public Stream Open()Returns
De stroom die de inhoud van het archief vertegenwoordigt.
Examples
Extract het archief en kopieert geëxtracteerde inhoud naar bestandstromen.
using (var archive = new ZstandardArchive("archive.zst"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}U kunt de methode Stream.CopyTo voor .NET 4.0 en hoger gebruiken: ‘unpacked.KopieTo(extracted);’
Remarks
Lees van de stroom om de oorspronkelijke inhoud van een bestand te krijgen. zie voorbeelden sectie.
Save(Stream, ZstandardSaveOptions)
Speel archief op de geleverde stroom.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parameters
outputStream Stream
De bestemming stroom.
settings ZstandardSaveOptions
Optionele instellingen voor archiefcompositie.
Examples
Schrijf gecomprimeerde gegevens in het HTTP-responsstream.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
moet geschreven zijn.
Exceptions
outputStream’ is not writable.
De bron is niet geleverd.
Save(String, ZstandardSaveOptions)
Het archief wordt opgeslagen naar het bestand van bestemming.
public void Save(string destinationFileName, ZstandardSaveOptions 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 ZstandardSaveOptions
Optionele instellingen voor archiefcompositie.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}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.
Save(FileInfo, ZstandardSaveOptions)
Het archief wordt opgeslagen naar het bestand van bestemming.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parameters
destination FileInfo
FileInfo, die zal worden geopend als bestemmingstromen.
settings ZstandardSaveOptions
Optionele instellingen voor archiefcompositie.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Exceptions
De oproeker heeft niet de vereiste toestemming om de bestemming 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.
destination’ is null.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
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 ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
Stel de inhoud in om in het archief te worden gecomprimeerd.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
De verwijzing naar een bestand om te worden gecomprimeerd.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(String)
Stel de inhoud in om in het archief te worden gecomprimeerd.
public void SetSource(string path)Parameters
path string
De weg naar het bestanden om gecomprimeerd te worden.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}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.
