Class SharArchive
ja nimityö: Aspose.Zip.Shar Kokoelma: Aspose.Zip.dll (25.5.0)
Tämä luokka edustaa terävää arkistotiedostoa.
public class SharArchive : IDisposableInheritance
Implements
Perintöjäsenet
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Aloittaa Aspose.Zip.Shar.SharArchive -luokan uusi esimerkki.
public SharArchive()Examples
Seuraava esimerkki osoittaa, miten tiedostoa puristetaan.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(String)
Aloitetaan Aspose.Zip.Shar.SharArchive-luokan uusi esimerkki, joka on valmis dekompresoimaan.
public SharArchive(string path)Parameters
path string
Matka arkiston lähteeseen.
Exceptions
path’ is null.
Kääntäjällä ei ole tarvittavaa käyttöoikeutta.
path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.
Pääsy path" -tiedostoon kielletään.
Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.
path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.
Tiedostoa ei löydy.
Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.
Tiedosto on jo auki.
Properties
Entries
Saa kirjoituksia Aspose.Zip.Shar.SharEntry -tyyppistä, joka muodostaa arkiston.
public ReadOnlyCollection<sharentry> Entries { get; }Omistuksen arvo
ReadOnlyCollection < SharEntry >
Methods
CreateEntries(Sormus ja bool)
Lisää arkistoon kaikki tiedostot ja luettelot toistuvasti annetussa luettelossa.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Ohjelma on kompressi.
includeRootDirectory bool
Se osoittaa, sisällytetäänkö root-direktiivi itse vai ei.
Returns
Sisäänkäynnin syy.
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.
Soittajalle ei ole tarvittavaa lupaa käyttää sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Tietyt reitit, tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla reitit on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Pääosat, Bool)
Lisää arkistoon kaikki tiedostot ja luettelot toistuvasti annetussa luettelossa.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Ohjelma on kompressi.
includeRootDirectory bool
Se osoittaa, sisällytetäänkö root-direktiivi itse vai ei.
Returns
Sisäänkäynnin syy.
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.
Soittajalle ei ole tarvittavaa lupaa käyttää direktiiviä”.
directory’ stands for a file, not for a directory.
CreateEntry(Tietokone, FileInfo ja Bool)
Luo yksi kirja arkiston sisällä.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Sisäänkäynnin nimi.
fileInfo FileInfo
Tiedoston tai tiedoston metatiedot tulee kompressoida.
openImmediately bool
Totuus, jos avaat tiedoston välittömästi, muuten avaa tiedosto arkiston tallennuksessa.
Returns
Sisäänkäynnin syy.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Jos tiedosto avautuu välittömästi parametrien avulla, se estetään, kunnes arkisto poistetaan.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String ja Bool)
Luo yksi kirja arkiston sisällä.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Sisäänkäynnin nimi.
sourcePath string
Matka tiedostoon kompresoida.
openImmediately bool
Totuus, jos avaat tiedoston välittömästi, muuten avaa tiedosto arkiston tallennuksessa.
Returns
Sisäänkäynnin syy.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
Sisällön nimi asetetaan vain parametrien sisällä. parametriin annettu tiedoston nimi ei vaikuta sisällön nimiin.
Jos tiedosto avautuu välittömästi parametrien avulla, se estetään, kunnes arkisto poistetaan.
Exceptions
sourcePath’ is null.
Kääntäjällä ei ole tarvittavaa käyttöoikeutta.
sourcePath’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä. - tai - Tiedoston nimi, osana name’, ylittää 100 merkkiä.
Pääsy sourcePath’ -tiedostoon kielletään.
Tietyt sourcePath’, tiedoston nimi, tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla, reitillä on oltava alle 248 merkkiä, ja tiedoston nimet on oltava alle 260 merkkiä. - tai - name’ on liian pitkä harmaalle.
sourcePath’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.
CreateEntry(virta, virta)
Luo yksi kirja arkiston sisällä.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Sisäänkäynnin nimi.
source Stream
Sisäänpääsy virtaa sisäänpääsyyn.
Returns
Sisäänkäynnin syy.
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)
Poistaa tietyn ilmoituksen ensimmäinen esiintyminen ilmoitusluettelosta.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
Sisäänpäätökset poistetaan luettelosta.
Returns
Sisäänkäynnin syy.
Examples
Tässä, miten voit poistaa kaikki kirjoitukset lukuun ottamatta viimeistä:
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(Sisältää)
Poista sisäänkirjautuminen sisäänkirjautumislistasta indeksiin.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Sisäänpääsyn nolla-pohjainen indeksi poistetaan.
Returns
Arkisto, jossa on sisäänpääsy poistettu.
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(Booli)
Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Hallittuja resursseja on käytettävä.
Dispose()
Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.
public void Dispose()Save(String)
Tallenna arkistoa määränpäätiedostoon.
public void Save(string destinationFileName)Parameters
destinationFileName string
Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
On mahdollista tallentaa arkisto samalle tielle kuin se ladattiin. kuitenkin, tämä ei ole suositeltavaa, koska tämä lähestymistapa käyttää kopiointia tilapäiseen tiedostoon.
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.
Määritetty destinationFileName’, tiedoston nimi, tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla reitin on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.
Määritetty destinationFileName’ ei ole pätevä (esimerkiksi se on kartattomalla laitteella).
Virhe I/O tapahtui tiedoston avaamisen aikana.
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.
Tiedostoa ei löydy.
Save(Stream)
Säästää arkistoa tarjottuun virtaukseen.
public void Save(Stream output)Parameters
output Stream
Tavoitteen virta.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Pitää olla kirjoitettavaa.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
