Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Štítek, XarLoadOptions)`

Začíná nový příklad třídy Aspose.Zip.Xar.xarArchive a sestaví seznam vstupů, které lze extrahovat z archivu.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Cesta do archivního souboru.

loadOptions XarLoadOptions

Možnosti načtení archiv.

`Examples`

Následující příklad ukazuje, jak extrahovat všechny vstupy do adresáře.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Tento výrobce nevybaluje žádné vstupy. viz Aspose.Zip.Xar.XarFileEntry.Open metoda pro vybalován.

`Exceptions`

path’ is null.

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.

InvalidDataException

Soubor na path’ není platný síťový archiv.

`Properties`

`Entries`

Obdrží záznamy typu Aspose.Zip.Xar.XarEntry tvořící archiv.

public IEnumerable<xarentry> Entries { get; }

`Hodnota nemovitosti`

IEnumerable < XarEntry >

`Methods`

`CreateEntries(Třída, bool, XarCompressionSettings)`

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

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

Přihláška k kompresu.

includeRootDirectory bool

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

compressionSettings XarCompressionSettings

Kompresní nastavení používané pro přidání položek Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Vstupní instance v ČR.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

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

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

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

Přihláška k kompresu.

includeRootDirectory bool

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

compressionSettings XarCompressionSettings

Kompresní nastavení používané pro přidání položek Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Vstupní instance v ČR.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

`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(řetěz, FileInfo, bool, XarCompressionSettings)`

Vytvořte jediný vstup do archivu.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

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

compressionSettings XarCompressionSettings

Kompresní nastavení používané pro přidání položky Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Vstupní instance v ČR.

`Examples`

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

`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(řetěz, řetěz, bool, XarCompressionSettings)`

Vytvořte jediný vstup do archivu.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

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

compressionSettings XarCompressionSettings

Kompresní nastavení používané pro přidání položky Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Vstupní instance v ČR.

`Examples`

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

`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ý pro xar.

NotSupportedException

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

Není možné změnit archiv.

`CreateEntry(String, Přetížení, XarCompressionSettings)`

Vytvořte jediný vstup do archivu.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Název vstupu.

source Stream

Vstupní proud pro vstup.

compressionSettings XarCompressionSettings

Kompresní nastavení používané pro přidání položky Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Vstupní instance v ČR.

`Examples`

using (var archive = new XarArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.xar");
}

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

Není možné změnit archiv.

`DeleteEntry(XarEntry)`

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

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Vstup k odstranění z seznamu vstup.

`Returns`

XarArchive

Vstupní instance v ČR.

`Examples`

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

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

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

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

`ExtractToDirectory(Stringová)`

Vytahuje všechny soubory v archivu do poskytnutého adresáře.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Cesta do adresáře umístit extrahované soubory do.

`Examples`

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Pokud adresář neexistuje, bude vytvořen.

`Exceptions`

Cesta je nulová

Zadaná trasa, název souboru nebo obojí přesahuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasa menší než 248 znaků a název souboru musí být menší než 260 znak.

Návštěvník nemá požadované povolení k přístupu k stávajícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, trasa obsahuje znak kolonu (:) který není součástí označení disku (“C:”).

trasa je nulová délka řetězu, obsahuje pouze bílý prostor, nebo obsahuje jeden nebo více neplatných znaků.Můžete požádat o neplatné znaky pomocí metody System.IO.Path.GetInvalidPathChars. -or- trasa je předem nastaven s, nebo obsahuje, pouze znak kolon (:).

dek určený cestou je soubor. -or- Název sítě není znám.

InvalidDataException

Archiv je zkorumpován.

`Save(Štítek, XarSaveOptions)`

Ušetří archiv na předloženém cílovém souboru.

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

`Parameters`

destinationFileName string

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

saveOptions XarSaveOptions

Možnosti pro ukládání souboru xar.

`Exceptions`

destinationFileName’ is null.

Není možné změnit archiv.

`Save(Přenos, XarSaveOptions)`

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

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

Destinace v toku.

saveOptions XarSaveOptions

Možnosti pro ukládání souboru xar.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.