Class SharArchive

Zákazník nemá požadované povolení k přístupu.

UnauthorizedAccessException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

Přístup k souboru path" je odmítnut.

DirectoryNotFoundException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

FileNotFoundException

Soubor nebyl nalezen.

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

Soubor je již otevřen.

`Properties`

`Entries`

Obdrží záznamy typu Aspose.Zip.Shar.SharEntry tvořící archiv.

public ReadOnlyCollection<sharentry> Entries { get; }

`Hodnota nemovitosti`

ReadOnlyCollection < SharEntry >

`Methods`

`CreateEntries(Stringová, boolová)`

Přidejte do archivu všechny soubory a adresáře opakovaně v daném adresáři.

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

`Parameters`

sourceDirectory string

Přihláška k kompresu.

includeRootDirectory bool

Ukazuje, zda zahrnout samotný kořenový adresář nebo ne.

`Returns`

Vstupní instance Shar.

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

Volající nemá požadované povolení k přístupu k sourceDirectory'.

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

Například na platformách založených na Windows musí být trasy menší než 248 znaků a názvy souborů musí být menší než 260 znak.

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

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

Přidejte do archivu všechny soubory a adresáře opakovaně v daném adresáři.

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

`Parameters`

directory DirectoryInfo

Přihláška k kompresu.

includeRootDirectory bool

Ukazuje, zda zahrnout samotný kořenový adresář nebo ne.

`Returns`

Vstupní instance Shar.

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

Volající nemá požadované povolení k přístupu k directory'.

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

`CreateEntry(String, FileInfo a bool)`

Vytvořte jediný vstup do archivu.

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

`Parameters`

name string

Název vstupu.

fileInfo FileInfo

Metadata souboru nebo složky, které mají být komprimovány.

openImmediately bool

Je pravda, že pokud otevřete soubor okamžitě, jinak otevřete soubor na archivní úspory.

`Returns`

SharEntry

Vstupní instance Shar.

`Examples`

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

`Remarks`

Pokud je soubor otevřen okamžitě s parametrem, blokuje se, dokud není archiv odstraněn.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(String, String a Bool)`

Vytvořte jediný vstup do archivu.

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

`Parameters`

name string

Název vstupu.

sourcePath string

Způsob, jak dosáhnout komprese.

openImmediately bool

Je pravda, že pokud otevřete soubor okamžitě, jinak otevřete soubor na archivní úspory.

`Returns`

SharEntry

Vstupní instance Shar.

`Examples`

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

`Remarks`

Vstupní název je nastaven pouze v rámci parametru. název souboru uvedený v parametru nemá vliv na vstupní název.

Pokud je soubor otevřen okamžitě s parametrem, blokuje se, dokud není archiv odstraněn.

`Exceptions`

sourcePath’ is null.

Zákazník nemá požadované povolení k přístupu.

UnauthorizedAccessException

code class=“paramref”>sourcePath’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky. - nebo - Název souboru, jako součást name’, přesahuje 100 symbol.

Přístup k souboru sourcePath’ je odmítnut.

Například na platformách založených na Windows musí být trasy menší než 248 znaků a názvy souborů musí být menší než 260 znaků. - nebo - name’ je příliš dlouhý na ostr.

NotSupportedException

Soubor na sourcePath’ obsahuje kolonu (:) uprostřed řádku.

`CreateEntry(Stretch , Stream)`

Vytvořte jediný vstup do archivu.

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

Název vstupu.

source Stream

Vstupní proud pro vstup.

`Returns`

SharEntry

Vstupní instance Shar.

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

Odstraňuje první výskyt konkrétního vstupu z seznamu vstup.

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

Vstup k odstranění z seznamu vstup.

`Returns`

Vstupní instance Shar.

`Examples`

Zde je, jak můžete odstranit všechny příspěvky s výjimkou posledn:

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

Odstraňuje vstup z seznamu vstupů indexem.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Nulový index vstupu, který je třeba odstranit.

`Returns`

ArgumentOutOfRangeException

Archiv s vstupem byl vymazán.

`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(Bolíček)`

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Je nutné zlikvidovat spravované zdroje.

`Dispose()`

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

public void Dispose()

`Save(Stringová)`

Shromažďuje archiv na poskytnutý cílový soubor.

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

`Examples`

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

`Remarks`

Je možné uložit archiv na stejnou cestu, jakou byl stažen z. Nicméně, to se nedoporučuje, protože tento přístup používá kopírování do dočasného souboru.

`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

Uvedený destinationFileName’, název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasy menší než 248 znaků a název souboru musí být menší než 260 znak.

Uvedený destinationFileName’ je neplatný (např. je na nezapsaném disku).

UnauthorizedAccessException

Při otevření souboru došlo k chybě 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

Soubor nebyl nalezen.

`Save(Stream)`

Ušetří archiv na poskytnutém toku.

public void Save(Stream output)

`Parameters`

output Stream

Destinace v toku.

`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í být psatelná.

`Exceptions`

output’ is null.