Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(String, XarLoadOptions)`

Initialiserer en ny instans af Aspose.Zip.Xar.xarArchive klasse og udgør en indgangsliste, der kan udvundes fra arkivet.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Vejen til arkiveret.

loadOptions XarLoadOptions

De muligheder for at oplade arkiver med.

`Examples`

Følgende eksempel viser, hvordan man udvider alle indtægter til en katalog.

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

`Remarks`

Denne konstruktør fjerner ingen indtægter. Se Aspose.Zip.Xar.XarFileEntry.Open metode for fjerner.

`Exceptions`

path’ is null.

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

UnauthorizedAccessException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

Tilgang til filen path’ er nægtet.

DirectoryNotFoundException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

FileNotFoundException

Filen er ikke fundet.

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

Filen er allerede åben.

InvalidDataException

Fil på path’ er ikke gyldig xar arkiv.

`Properties`

`Entries`

Få indtægter af Aspose.Zip.Xar.XarEntry type, der udgør arkivet.

public IEnumerable<xarentry> Entries { get; }

`Ejendomsværdi`

IEnumerable < XarEntry >

`Methods`

`CreateEntries(String, Bool, XarCompressionSettings)`

Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.

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

`Parameters`

sourceDirectory string

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

compressionSettings XarCompressionSettings

Komprimeringsindstillingerne bruges til at tilføje Aspose.Zip.Xar.XarEntry elementer.

`Returns`

XarArchive

Indtægtsindtægtsindtægtsindtægts.

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

Ringeren har ikke den nødvendige tilladelse til at få adgang til sourceDirectory'.

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

Den angivne vej, filnavn, eller begge overskrider den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal vejene være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. Den angivne vej, filnavn, eller begge er for lange.

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

`CreateEntries(DirectoryInfo, bool, XarCompressionSettings)`

Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.

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

`Parameters`

directory DirectoryInfo

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

compressionSettings XarCompressionSettings

Komprimeringsindstillingerne bruges til at tilføje Aspose.Zip.Xar.XarEntry elementer.

`Returns`

XarArchive

Indtægtsindtægtsindtægtsindtægts.

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

Ringeren har ikke den nødvendige tilladelse til at få adgang til direktory'.

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

`CreateEntry(string, FileInfo, bool, XarCompressionSettings)`

Skab en enkelt indgang i arkivet.

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

`Parameters`

name string

Navnet på indgangen.

fileInfo FileInfo

Metadata af filen eller mappen skal komprimeres.

openImmediately bool

Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.

compressionSettings XarCompressionSettings

Komprimeringsindstillingerne bruges til at tilføje Aspose.Zip.Xar.XarEntry element.

`Returns`

XarEntry

Indtægtsindtægtsindtægtsindtægts.

`Examples`

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

`Remarks`

Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string, string, bool, XarCompressionSettings)`

Skab en enkelt indgang i arkivet.

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

`Parameters`

name string

Navnet på indgangen.

sourcePath string

Vejen til fil at blive komprimeret.

openImmediately bool

Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.

compressionSettings XarCompressionSettings

Komprimeringsindstillingerne bruges til at tilføje Aspose.Zip.Xar.XarEntry element.

`Returns`

XarEntry

Indtægtsindtægtsindtægtsindtægts.

`Examples`

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

`Remarks`

Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.

Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.

`Exceptions`

sourcePath’ is null.

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

UnauthorizedAccessException

code class=“paramref”>sourcePath’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn. - eller - Filnavn, som en del af name’, overstiger 100 symboler.

Tilgang til filen sourcePath’ er nægtet.

Den angivne sourcePath’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. - eller - name’ er for lang til xar.

NotSupportedException

Filen på sourcePath’ indeholder en kolonne (:) i midten af ringen.

Det er umuligt at ændre arkiverne.

`CreateEntry(Strøm, Strøm, XarCompressionSettings)`

Skab en enkelt indgang i arkivet.

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

`Parameters`

name string

Navnet på indgangen.

source Stream

Indtægtsstrøm for indtægten.

compressionSettings XarCompressionSettings

Komprimeringsindstillingerne bruges til at tilføje Aspose.Zip.Xar.XarEntry element.

`Returns`

XarEntry

Indtægtsindtægtsindtægtsindtægts.

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

Det er umuligt at ændre arkiverne.

`DeleteEntry(XarEntry)`

Det fjerner den første forekomst af en bestemt indtastning fra indtastningslisten.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Indtægten skal fjernes fra listen over indtægter.

`Returns`

XarArchive

Indtægtsindtægtsindtægtsindtægts.

`Examples`

Her er, hvordan du kan fjerne alle indtægter undtagen den sidste:

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

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

`Dispose(Bool)`

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Om de forvaltede ressourcer skal fjernes.

`ExtractToDirectory(String)`

Udveksler alle filer i arkivet til den leverede katalog.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Vejen til katalogen til at placere de udvundne filer i.

`Examples`

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

`Remarks`

Hvis katalogen ikke eksisterer, vil den blive oprettet.

`Exceptions`

Vejen er null

Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.

Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.

NotSupportedException

Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“C:”).

Vejen er en nulllængde, indeholder kun hvid plads, eller indeholder en eller flere invalide tegn. Du kan anmode om invalide tegn ved hjælp af System.IO.Path.GetInvalidPathChars metode. -eller- Vejen er forhåndsbestemt med, eller indeholder, kun en kolon karakter (:).

Den katalog, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.

InvalidDataException

Arkiverne er korrupte.

`Save(String, XarSaveOptions)`

Sparer arkiver til den foreløbige fil, der leveres.

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

`Parameters`

destinationFileName string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

saveOptions XarSaveOptions

Alternativer til at gemme xar arkiver med.

`Exceptions`

destinationFileName’ is null.

Det er umuligt at ændre arkiverne.

`Save(Strøm, XarSaveOptions)`

Sparer arkiver til den leverede strøm.

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

`Parameters`

output Stream

Destinationstrøm.

saveOptions XarSaveOptions

Alternativer til at gemme xar arkiver med.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.