Class SharArchive
A név: Aspose.Zip.Shar Összefoglaló: Aspose.Zip.dll (25.5.0)
Ez az osztály egy éles archív fájlt képvisel.
public class SharArchive : IDisposableInheritance
Implements
Örökletes tagok
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Kezdeményez egy új példát az Aspose.Zip.Shar.SharArchive osztály.
public SharArchive()Examples
Az alábbi példa azt mutatja, hogyan kell tömöríteni egy fájlt.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(A string)
Kezdeményez egy új példát az Aspose.Zip.Shar.SharArchive osztály felkészült a dekompresszió.
public SharArchive(string path)Parameters
path string
Az út az archívum forrásához.
Exceptions
path’ is null.
A hívó nem rendelkezik a szükséges hozzáférési engedélygel.
A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.
A path" fájlhoz való hozzáférés elutasításra kerül.
A meghatározott path", fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.
A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.
A fájlt nem találták meg.
A kijelölt út nem érvényes, például egy mappátlan vezérlésen.
A fájl már nyitva van.
Properties
Entries
Kap bejegyzéseit Aspose.Zip.Shar.SharEntry típus alkotja az archívumot.
public ReadOnlyCollection<sharentry> Entries { get; }ingatlan értéke
ReadOnlyCollection < SharEntry >
Methods
CreateEntries(Szilveszter, Bool)
Hozzáadja az archívumhoz az összes fájlt és címkéket az adott címkében ismétlődően.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
A kompressziós kézikönyv.
includeRootDirectory bool
Megmutatja, hogy magában foglalja-e a gyökérdirektorát vagy sem.
Returns
Bejelentkezési eljárás.
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.
A hívó nem rendelkezik a sourceDirectory’hoz való hozzáféréshez szükséges engedélygel.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
A meghatározott útvonal, a fájl neve vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájl neve kevesebbnek kell lennie, mint 260 karakter.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Részletesebben Bool, Bool)
Hozzáadja az archívumhoz az összes fájlt és címkéket az adott címkében ismétlődően.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
A kompressziós kézikönyv.
includeRootDirectory bool
Megmutatja, hogy magában foglalja-e a gyökérdirektorát vagy sem.
Returns
Bejelentkezési eljárás.
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.
A hívó nem rendelkezik a directory’hoz való hozzáféréshez szükséges engedélygel.
directory’ stands for a file, not for a directory.
CreateEntry(Részletesebben FileInfo, Bool)
Hozzon létre egy egységes bejegyzést az archívumban.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
A bejárat neve.
fileInfo FileInfo
A fájl vagy a mappa metadata nyomtatásra kerül.
openImmediately bool
Igaz, ha azonnal megnyitja a fájlt, különben megnyitja a fájlt az archív mentés.
Returns
Bejelentkezési eljárás.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Ha a fájl azonnal megnyílik a paraméterrel, akkor az archívum megszűnik.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(szál, szál, szál)
Hozzon létre egy egységes bejegyzést az archívumban.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
A bejárat neve.
sourcePath string
A nyomtatás útja a nyomtatáshoz.
openImmediately bool
Igaz, ha azonnal megnyitja a fájlt, különben megnyitja a fájlt az archív mentés.
Returns
Bejelentkezési eljárás.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
A paraméterben megadott fájl neve nem befolyásolja a bejegyzés nevét.
Ha a fájl azonnal megnyílik a paraméterrel, akkor az archívum megszűnik.
Exceptions
sourcePath’ is null.
A hívó nem rendelkezik a szükséges hozzáférési engedélygel.
A sourcePath’ üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz. - vagy - A fájl neve, a name’ részeként, meghaladja a 100 szimbólumot.
A sourcePath” fájlhoz való hozzáférést elutasítják.
A meghatározott sourcePath’, fájl neve, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalaknak kevesebbnek kell lenniük, mint 248 karakter, és a fájlneveknek kevesebbnek kell lenniük, mint 260 karakter. - vagy - name’ túl hosszú a sima.
A sourcePath’ fájl tartalmaz egy oszlopot (:) a sor közepén.
CreateEntry(Áramlás, Stream)
Hozzon létre egy egységes bejegyzést az archívumban.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
A bejárat neve.
source Stream
A belépési áram a belépéshez.
Returns
Bejelentkezési eljárás.
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)
Eltávolítja egy adott bejegyzés első megjelenését a bejegyzéslistából.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
A bejegyzést a bejegyzési listából kell eltávolítani.
Returns
Bejelentkezési eljárás.
Examples
Íme, hogyan lehet eltávolítani az összes bejegyzés kivéve az utolsó:
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)
Távolítsa el a bejegyzést a bejegyzési listából index szerint.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
A nulla-alapú index a bejárat eltávolítására.
Returns
Az archívumot a bejárattal törölték.
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(Bóli)
Alkalmazás-meghatározott feladatokat végez, amelyek a nem kezelt erőforrások felszabadításával, felszabadításával vagy újrahasznosításával kapcsolatosak.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
A kezelt erőforrások megszüntetésére van szükség.
Dispose()
Alkalmazás-meghatározott feladatokat végez, amelyek a nem kezelt erőforrások felszabadításával, felszabadításával vagy újrahasznosításával kapcsolatosak.
public void Dispose()Save(A string)
Adja meg az archívumot a megadott célfájlra.
public void Save(string destinationFileName)Parameters
destinationFileName string
Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Az archívumot ugyanolyan úton lehet menteni, mint amilyenről letöltött. azonban ez nem ajánlott, mert ez a megközelítés egy ideiglenes fájlra másolja.
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.
A meghatározott destinationFileName’, fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.
A meghatározott destinationFileName’ nem érvényes (például egy nem mappált lemezre található).
Az I/O hiba bekövetkezett a fájl megnyitásakor.
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.
A fájlt nem találták meg.
Save(Stream)
Megtakarítja az archívumot a megadott áramláshoz.
public void Save(Stream output)Parameters
output Stream
A cél áramlása.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
írásszerűnek kell lennie.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
