Class SharArchive

Návštevník nemá požadované povolenie na prístup.

UnauthorizedAccessException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

Prístup k súboru path" je zamietnutý.

DirectoryNotFoundException

Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

NotSupportedException

Súbor na path’ obsahuje stĺpec (:) v strede riadku.

FileNotFoundException

Súbor sa nenašiel.

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

Súbor je už otvorený.

`Properties`

`Entries`

Získava záznamy typu Aspose.Zip.Shar.SharEntry, ktorý tvorí archív.

public ReadOnlyCollection<sharentry> Entries { get; }

`Hodnota nehnuteľnosti`

ReadOnlyCollection < SharEntry >

`Methods`

`CreateEntries(striekačka, bool)`

Pridajte do archívu všetky súbory a adresáre opakovane v danom adresári.

public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

`Parameters`

sourceDirectory string

Príručka na kompresiu.

includeRootDirectory bool

Ukazuje, či zahŕňať samotný koreňový adresár alebo nie.

`Returns`

Vstupná inštancia Šar.

`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.

Volávač nemá požadované povolenie na prístup k sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

Ustanovená trasa, názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows musia byť trasy menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov. Ustanovená trasa, názov súboru alebo obaja sú príliš dlhé.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(Úvodná stránka > Bool)`

Pridajte do archívu všetky súbory a adresáre opakovane v danom adresári.

public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

`Parameters`

directory DirectoryInfo

Príručka na kompresiu.

includeRootDirectory bool

Ukazuje, či zahŕňať samotný koreňový adresár alebo nie.

`Returns`

Vstupná inštancia Šar.

`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.

Volávač nemá požadované povolenie na prístup k directory”.

directory’ stands for a file, not for a directory.

`CreateEntry(Príslušenstvo, FileInfo, Bool)`

Vytvorte jediný vstup v archíve.

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`Parameters`

name string

Názov vstupu.

fileInfo FileInfo

Metadata súboru alebo priečinka sa majú komprimovať.

openImmediately bool

Je pravda, že ak otvoríte súbor ihneď, inak otvoríte súbor na archívnom úložisku.

`Returns`

SharEntry

Vstupná inštancia Šar.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.shar");
}

`Remarks`

Ak sa súbor otvorí okamžite s parametrom, blokuje sa až do odstránenia archívu.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(String, String a Bool)`

Vytvorte jediný vstup v archíve.

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

Názov vstupu.

sourcePath string

Spôsob, ako dosiahnuť, aby bol komprimovaný.

openImmediately bool

Je pravda, že ak otvoríte súbor ihneď, inak otvoríte súbor na archívnom úložisku.

`Returns`

SharEntry

Vstupná inštancia Šar.

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.shar");
}

`Remarks`

Názov súboru uvedený v paramete nemá vplyv na názov súboru.

Ak sa súbor otvorí okamžite s parametrom, blokuje sa až do odstránenia archívu.

`Exceptions`

sourcePath’ is null.

Návštevník nemá požadované povolenie na prístup.

UnauthorizedAccessException

sourcePath’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky. - alebo - Názov súboru, ako súčasť name’, presahuje 100 symbolov.

Prístup k súboru sourcePath’ je zamietnutý.

Zadaný sourcePath’, názov súboru, alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov. - alebo - name’ je príliš dlhý na ostrý.

NotSupportedException

Súbor v sourcePath’ obsahuje stĺpec (:) v strede riadku.

`CreateEntry(Stream , Stream)`

Vytvorte jediný vstup v archíve.

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

Názov vstupu.

source Stream

Vstupný prúd pre vstup.

`Returns`

SharEntry

Vstupná inštancia Šar.

`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)`

Odstráni prvý výskyt konkrétneho vstupu z zoznamu vstupov.

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

Vstup na odstránenie z zoznamu vstupov.

`Returns`

Vstupná inštancia Šar.

`Examples`

Tu je, ako môžete odstrániť všetky záznamy s výnimkou posledného:

using (var archive = new SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(int)`

Odstrániť vstup z vstupného zoznamu podľa indexu.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Null-based index vstupu odstrániť.

`Returns`

ArgumentOutOfRangeException

Archív s vstupom je odstránený.

`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(bool)`

Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Mali by sa riadiť riadené zdroje.

`Dispose()`

Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.

public void Dispose()

`Save(Stretnutie)`

Uloží archív do poskytnutého cieľového súboru.

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

`Remarks`

Je možné uložiť archív na rovnakú cestu, ako bola naložená z. Avšak, to sa neodporúča, pretože tento prístup používa kopírovanie do dočasného súboru.

`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.

DirectoryNotFoundException

Určená destinationFileName’, názov súboru, alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

Uvedený destinationFileName’ je neplatný, (napríklad je to na nezapísanom disku).

UnauthorizedAccessException

Pri otvorení súboru sa vyskytla chyba I/O.

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.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

Súbor sa nenašiel.

`Save(Stream)`

Úspora archívov na poskytnutý prúd.

public void Save(Stream output)

`Parameters`

output Stream

Cestovný prúd .

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

Musí byť písateľná.

`Exceptions`

output’ is null.