Class ZArchive
Namn på plats: Aspose.Zip.Z Sammanfattning: Aspose.Zip.dll (25.5.0)
Denna klass representerar en Z (komprimerad) arkivfil. Använd den för att komponera eller extrahera Z arkiv.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Arvsmedlemmar
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
Se https://docs.fileformat.com/kompression/z/
Constructors
arkiv()
Initialiserar en ny instans av Aspose.Zip.Z.Archive-klassen förberedd för komprimering.
public ZArchive()
arkiv(Ström, ZArchiveLoadOptions)
Initialiserar en ny instans av Aspose.Zip.Z.Archive-klassen förberedd för dekomprimering.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parameters
source
Stream
Källan till arkivet.
loadOptions
ZArchiveLoadOptions
Alternativ för att ladda arkiv med.
Remarks
Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metod för dekomprimering.
Exceptions
source’ is not seekable.
source’ is null.
arkiv(Sträng, ZArchiveLoadOptions)
Initialiserar en ny instans av Aspose.Zip.Z.Archive-klassen förberedd för dekomprimering.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parameters
path
string
Vägen till källan till arkivet.
loadOptions
ZArchiveLoadOptions
Alternativ för att ladda arkiv med.
Remarks
Denna konstruktör dekomprimerar inte. Se Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metod för dekomprimering.
Exceptions
path’ is null.
Sökanden har inte behörig tillstånd att komma åt.
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
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.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Filen hittades inte.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
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 Z arkiv till en ström.
public void Extract(Stream destination)
Parameters
destination
Stream
Stream för lagring av dekomprimerade data.
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
Data kan inte dekomprimeras.
Extract(FileInfo)
Extract Z arkiv till en fil.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo för lagring av dekomprimerade data.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Ringaren har inte tillståndet att öppna fileInfo'.
Filvägen är tom eller innehåller endast vita utrymmen.
Filen hittades inte.
Vägen till filen är läsbart eller är en katalog.
fileInfo’ is null.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
Data kan inte dekomprimeras.
Extract(Sträng)
Extract Z 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
Information om en extraherad fil.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
path’ is null.
Sökanden har inte behörig tillstånd att komma åt.
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
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.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Data kan inte dekomprimeras.
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
destinationDirectory’ is null.
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.
Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.
Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“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 som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.
Save(Ström, ZArchiveSaveOptions)
Spara xz arkiv till den tillhandahållna strömmen.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parameters
output
Stream
Destination strömmar.
settings
ZArchiveSaveOptions
Optionella inställningar för arkivkomposition.
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Remarks
Måste vara sökbar.
Exceptions
output’ does not support seeking.
output’ is null.
Save(String, ZArchiveSaveOptions)
Spara Z-arkiv till den angivna beställningsfilen.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Parameters
destinationFileName
string
Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.
settings
ZArchiveSaveOptions
Optionella inställningar för arkivkomposition.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Exceptions
destinationFileName’ is null.
Sökanden har inte behörig tillstånd att komma åt.
destinationFileName’ är tom, innehåller endast vita utrymmen, eller innehåller ogiltiga tecken.
Tillgång till filen destinationFileName’ vägras.
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.
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 ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
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 ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Exceptions
Ringaren har inte tillståndet att öppna fileInfo'.
Filvägen är tom eller innehåller endast vita utrymmen.
Filen hittades inte.
Vägen till filen är läsbart eller är en katalog.
fileInfo’ is null.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
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 ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Exceptions
sourcePath’ is null or empty string.
Sökanden har inte behörig behörighet att få tillgång till en resurs.
sourcePath’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen sourcePath’ vägras.
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.
Filen i sourcePath’ innehåller en kolumn (:) i mitten av raden.