Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Denna klass representerar Z (komprimera) arkivfil. Använd den för att komponera eller extrahera Z-arkiv.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
Arv
Implementerar
IArchive, IDisposable, IArchiveFileEntry
Ärvda Medlemmar
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Kommentarer
Se https://docs.fileformat.com/compression/z/
Konstruktörer
ZArchive()
Initierar en ny instans av Aspose.Zip.Z.ZArchive-klassen förberedd för komprimering.
public ZArchive()
ZArchive(Stream, ZArchiveLoadOptions)
Initierar en ny instans av Aspose.Zip.Z.ZArchive-klassen förberedd för dekomprimering.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parametrar
source
Stream
Källan till arkivet.
loadOptions
ZArchiveLoadOptions
Alternativen för att ladda arkivet med.
Kommentarer
Denna konstruktor dekomprimerar inte. Se metoden Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) för dekomprimering.
Undantag
source
är inte sökbar.
source
är null.
ZArchive(string, ZArchiveLoadOptions)
Initierar en ny instans av Aspose.Zip.Z.ZArchive-klassen förberedd för dekomprimering.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parametrar
path
string
Sökväg till källan för arkivet.
loadOptions
ZArchiveLoadOptions
Alternativen för att ladda arkivet med.
Kommentarer
Denna konstruktor dekomprimerar inte. Se metoden Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) för dekomprimering.
Undantag
path
är null.
Anroparen har inte nödvändiga behörigheter för att få åtkomst.
path
är tom, innehåller endast vita ytor eller innehåller ogiltiga tecken.
Åtkomst till fil path
nekas.
Den angivna path
, filnamn, eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Fil på path
innehåller ett kolon (:) i mitten av strängen.
Fil hittades inte.
Den angivna sökvägen är ogiltig, som att vara på en icke-kartlagd enhet.
Fil är redan öppen.
Metoder
Dispose()
Utför applikationsdefinierade uppgifter kopplade till frigörande, släppande eller återställande av icke-hanterade resurser.
public void Dispose()
Dispose(bool)
Utför applikationsdefinierade uppgifter kopplade till frigörande, släppande eller återställande av icke-hanterade resurser.
protected virtual void Dispose(bool disposing)
Parametrar
disposing
bool
Om hanterade resurser ska avyttras.
Extract(Stream)
Extraherar Z-arkiv till en ström.
public void Extract(Stream destination)
Parametrar
destination
Stream
Ström för att lagra dekomprimerade data.
Exempel
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);
}
}
}
Undantag
Data kan inte dekomprimeras.
Extract(FileInfo)
Extraherar Z-arkiv till en fil.
public void Extract(FileInfo fileInfo)
Parametrar
fileInfo
FileInfo
FileInfo för att lagra dekomprimerade data.
Exempel
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Undantag
Anroparen har inte nödvändiga behörigheter för att öppna fileInfo
.
Filens sökväg är tom eller innehåller endast vita ytor.
Fil hittades inte.
Sökväg till fil är skrivskyddad eller är en katalog.
fileInfo
är null.
Den angivna sökvägen är ogiltig, som att vara på en icke-kartlagd enhet.
Fil är redan öppen.
Data kan inte dekomprimeras.
Extract(string)
Extraherar Z-arkiv till en fil via sökväg.
public FileInfo Extract(string path)
Parametrar
path
string
Sökväg till fil som kommer att lagra dekomprimerade data.
Returer
Info om den extraherade filen.
Exempel
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
Undantag
path
är null.
Anroparen har inte nödvändiga behörigheter för att få åtkomst.
path
är tom, innehåller endast vita ytor, eller innehåller ogiltiga tecken.
Åtkomst till fil path
nekas.
Den angivna path
, filnamn, eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Fil på path
innehåller ett kolon (:) i mitten av strängen.
Data kan inte dekomprimeras.
ExtractToDirectory(string)
Extraherar innehållet i arkivet till den angivna katalogen.
public void ExtractToDirectory(string destinationDirectory)
Parametrar
destinationDirectory
string
Sökväg till katalogen för att placera de extraherade filerna.
Kommentarer
Om katalogen inte finns kommer den att skapas.
Undantag
destinationDirectory
är null.
Den angivna sökvägen, filnamn, eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Anroparen har inte nödvändiga behörigheter för att få åtkomst till befintlig katalog.
Om katalogen inte finns, innehåller sökvägen ett kolon-tecken (:) som inte är en del av en enhetsbeteckning (“C:").
destinationDirectory
är en noll-längd sträng, innehåller endast vita ytor, eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken genom att använda metoden System.IO.Path.GetInvalidPathChars.
-eller- sökvägen är prefixad med, eller innehåller, endast ett kolon-tecken (:).
Den angivna sökvägen är en fil. -eller- Det nätverksnamnet är inte känt.
Save(Stream, ZArchiveSaveOptions)
Sparar xz-arkiv till den angivna strömmen.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parametrar
output
Stream
Destinationström.
settings
ZArchiveSaveOptions
Valfria inställningar för arkivkomposition.
Exempel
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Kommentarer
output
måste vara sökbar.
Undantag
output
stöder inte sökning.
output
är null.
Save(string, ZArchiveSaveOptions)
Sparar Z-arkivet till den angivna destinationsfilen.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Parametrar
destinationFileName
string
+Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil, kommer den att skrivas över.
settings
ZArchiveSaveOptions
Valfria inställningar för arkivkomposition.
Exempel
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Undantag
destinationFileName
är null.
Anroparen har inte nödvändiga behörigheter för att få åtkomst.
destinationFileName
är tom, innehåller endast vita ytor, eller innehåller ogiltiga tecken.
Åtkomst till fil destinationFileName
nekas.
Den angivna destinationFileName
, filnamn, eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Fil på destinationFileName
innehåller ett kolon (:) i mitten av strängen.
SetSource(Stream)
Sätter innehållet som ska komprimeras inom arkivet.
public void SetSource(Stream source)
Parametrar
source
Stream
Indataström för arkivet.
Exempel
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
Sätter innehållet som ska komprimeras inom arkivet.
public void SetSource(FileInfo fileInfo)
Parametrar
fileInfo
FileInfo
FileInfo som kommer att öppnas som indataström.
Exempel
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Undantag
Anroparen har inte nödvändiga behörigheter för att öppna fileInfo
.
Filens sökväg är tom eller innehåller endast vita ytor.
Fil hittades inte.
Sökväg till fil är skrivskyddad eller är en katalog.
fileInfo
är null.
Den angivna sökvägen är ogiltig, som att vara på en icke-kartlagd enhet.
Fil är redan öppen.
SetSource(string)
Sätter innehållet som ska komprimeras inom arkivet.
public void SetSource(string sourcePath)
Parametrar
sourcePath
string
Sökväg till fil som kommer att öppnas som indataström.
Exempel
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Undantag
sourcePath
är null eller tom sträng.
Anroparen har inte nödvändiga behörigheter för att få åtkomst till en resurs.
sourcePath
är tom, innehåller endast vita ytor, eller innehåller ogiltiga tecken.
Åtkomst till fil sourcePath
nekas.
Den angivna sourcePath
, filnamn, eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Fil på sourcePath
innehåller ett kolon (:) i mitten av strängen.