Class SharArchive
nazivni prostor: Aspose.Zip.Shar Sastav: Aspose.Zip.dll (25.5.0)
Ova klasa predstavlja oštar arhivski datoteku.
public class SharArchive : IDisposableInheritance
Implements
naslijeđeni članovi
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Inicijalizira novu primjenu klase Aspose.Zip.Shar.SharArchive.
public SharArchive()Examples
Sljedeći primjer pokazuje kako komprimirati datoteku.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(String)
Inicijalizira novi primjer Aspose.Zip.Shar.SharArchive klase pripremljen za dekompresiju.
public SharArchive(string path)Parameters
path string
Put do izvora arhiva.
Exceptions
path’ is null.
Pozivač nema potrebnu dozvolu za pristup.
path’ je prazan, sadrži samo bijele prostore, ili sadrži nevažeće znakove.
Pristup datoteci path" je odbijen.
Na primjer, na Windows platformama, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova.
File na path’ sadrži kolona (:) u sredini trake.
Dosje nije pronađeno.
Navedeni put je nevažeći, na primjer, biti na nemapiranom pogonu.
Dosje je već otvoreno.
Properties
Entries
Dobiva ulaznice tipa Aspose.Zip.Shar.SharEntry koji čine arhiv.
public ReadOnlyCollection<sharentry> Entries { get; }Vrijednost nekretnina
ReadOnlyCollection < SharEntry >
Methods
CreateEntries(Sljedeći Članak Bool)
Dodajte u arhiv sve datoteke i zapise ponavljajući se u određenom zapisu.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Direktorat za kompresije.
includeRootDirectory bool
To ukazuje na to treba li uključiti sam korijenski katalog ili ne.
Returns
Ulaznica za ulazak.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(sharFile);
}
}Exceptions
sourceDirectory’ is null.
Pozivač nema potrebnu dozvolu za pristup sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Na primjer, na Windows platformama, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Sljedeći članakInfo, bool)
Dodajte u arhiv sve datoteke i zapise ponavljajući se u određenom zapisu.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Direktorat za kompresije.
includeRootDirectory bool
To ukazuje na to treba li uključiti sam korijenski katalog ili ne.
Returns
Ulaznica za ulazak.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(sharFile);
}
}Exceptions
directory’ is null.
Pozivač nema potrebnu dozvolu za pristup directory”.
directory’ stands for a file, not for a directory.
CreateEntry(Slijedeći članakFileInfo, bool)
Stvorite jedinstvenu ulaznicu u arhivu.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Naziv ulaznice.
fileInfo FileInfo
Metapodatke datoteke ili mape koje treba komprimirati.
openImmediately bool
Istina, ako odmah otvorite datoteku, inače otvorite datoteku na arhivskom skladištenju.
Returns
Ulaznica za ulazak.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Ako se datoteka odmah otvori s parametrom, blokira se sve dok se arhiv ne ukloni.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String i Bool)
Stvorite jedinstvenu ulaznicu u arhivu.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Naziv ulaznice.
sourcePath string
Slijedeći članakSlijedeći članakSlijedeći članakSlijedeći članakSlijedeći članakSlijedeće →
openImmediately bool
Istina, ako odmah otvorite datoteku, inače otvorite datoteku na arhivskom skladištenju.
Returns
Ulaznica za ulazak.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
Naziv ulaza je postavljen isključivo unutar parametara. ime datoteke navedeno u parametru ne utječe na ime ulaza.
Ako se datoteka odmah otvori s parametrom, blokira se sve dok se arhiv ne ukloni.
Exceptions
sourcePath’ is null.
Pozivač nema potrebnu dozvolu za pristup.
sourcePath’ je prazan, sadrži samo bijele prostore, ili sadrži nevažeće znakove. - ili - Ime datoteke, kao dio name’, premašuje 100 simbola.
Pristup datoteci sourcePath’ je odbijen.
Na primjer, na platformama s Windows-om, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova. - ili - name’ je previše dugo za oštar.
File u sourcePath’ sadrži kolona (:) u sredini trake.
CreateEntry(Slijedeći Članak Stream)
Stvorite jedinstvenu ulaznicu u arhivu.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Naziv ulaznice.
source Stream
Ulaznice za ulaz.
Returns
Ulaznica za ulazak.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.shar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
DeleteEntry(SharEntry)
Ukloni prvu pojavu određenog ulaza s popisa ulaza.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
Ulazak treba ukloniti s popisa ulazaka.
Returns
Ulaznica za ulazak.
Examples
Evo kako možete ukloniti sve prijave osim posljednjeg:
using (var archive = new SharArchive("archive.shar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputSharFile);
}Exceptions
entry’ is null.
DeleteEntry(int)
Uklanjanje ulaznice s popisa ulaznica po indeksu.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Indeks na temelju nule ulaza treba ukloniti.
Returns
Slijedeći članakArhiva s ulazom uklonjena
Examples
using (var archive = new SharArchive("two_files.shar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.shar");
}Exceptions
entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.
Dispose(Bolić)
On obavlja zadatke definirane po aplikaciji povezane s oslobađanjem, oslobađanjem ili ponovnim oslobađanjem nekontroliranih resursa.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Treba li iskoristiti upravljane resurse.
Dispose()
On obavlja zadatke definirane po aplikaciji povezane s oslobađanjem, oslobađanjem ili ponovnim oslobađanjem nekontroliranih resursa.
public void Dispose()Save(String)
Sačuvajte arhiv za dostavljenu dosjeu odredišta.
public void Save(string destinationFileName)Parameters
destinationFileName string
Ako određeno ime datoteke ukazuje na postojeće datoteke, to će biti prepisano.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Moguće je sačuvati arhiv na istom putu kao što je preuzeta. međutim, to se ne preporučuje jer ovaj pristup koristi kopiranje na privremeni datoteku.
Exceptions
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
Na primjer, na platformama s Windows-om, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova.
Navedena destinationFileName’ je nevažeća (na primjer, ona se nalazi na nemapiranom disku).
I/O pogreška dogodila se prilikom otvaranja datoteke.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
Dosje nije pronađeno.
Save(Stream)
Sačuvajte arhiv na pruženi tok.
public void Save(Stream output)Parameters
output Stream
Odredište za tok.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Mora biti pismen.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
