Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Sträng, XarLoadOptions)`

Initialiserar en ny instans av Aspose.Zip.Xar.xarArchivklassen och utgör en inlistan som kan extraheras från arkivet.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Vägen till arkivfilen.

loadOptions XarLoadOptions

Alternativ för att ladda arkiv med.

`Examples`

Följande exempel visar hur man extraherar alla poster till en katalog.

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

`Remarks`

Denna konstruktör avpackar inte någon inmatning. Se Aspose.Zip.Xar.XarFileEntry.Open metod för avpackning.

`Exceptions`

path’ is null.

Sökanden har inte behörig tillstånd att komma åt.

UnauthorizedAccessException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

Tillgång till filen path" vägras.

DirectoryNotFoundException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

FileNotFoundException

Filen hittades inte.

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

Filen är redan öppen.

InvalidDataException

Filen på path’ är inte giltig xar arkiv.

`Properties`

`Entries`

Få inmatningar av Aspose.Zip.Xar.XarEntry-typ som utgör arkivet.

public IEnumerable<xarentry> Entries { get; }

`Fastighetsvärde`

IEnumerable ochlt; XarEntry >

`Methods`

`CreateEntries(sträng, bool, XarCompressionSettings)`

Lägg till arkivet alla filer och kataloger återkommande i den angivna katalogen.

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

`Parameters`

sourceDirectory string

katalog för komprimering.

includeRootDirectory bool

Anger om du ska inkludera rötdiagrammet själv eller inte.

compressionSettings XarCompressionSettings

De komprimeringsinställningar som används för att lägga till Aspose.Zip.Xar.XarEntry objekt.

`Returns`

XarArchive

Xar inträdesinstans.

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

Ringaren har inte nödvändig tillstånd att komma åt sourceDirectory'.

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

Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamnen måste vara mindre än 260 tecken.

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

`CreateEntries(DirectoryInfo, bool, XarCompressionSettings)`

Lägg till arkivet alla filer och kataloger återkommande i den angivna katalogen.

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

`Parameters`

directory DirectoryInfo

katalog för komprimering.

includeRootDirectory bool

Anger om du ska inkludera rötdiagrammet själv eller inte.

compressionSettings XarCompressionSettings

De komprimeringsinställningar som används för att lägga till Aspose.Zip.Xar.XarEntry objekt.

`Returns`

XarArchive

Xar inträdesinstans.

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

Ringaren har inte nödvändig tillstånd att komma åt direktory”.

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

`CreateEntry(sträng, FileInfo, bool, XarCompressionSettings)`

Skapa en enda inmatning inom arkivet.

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

`Parameters`

name string

Namnet på ingången.

fileInfo FileInfo

Metadata av filen eller mappen ska komprimeras.

openImmediately bool

Det är sant, om du öppnar filen omedelbart, annars öppnar du filen på arkivspara.

compressionSettings XarCompressionSettings

De komprimeringsinställningar som används för att lägga till Aspose.Zip.Xar.XarEntry objekt.

`Returns`

XarEntry

Xar inträdesinstans.

`Examples`

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

`Remarks`

Om filen öppnas omedelbart med parameter blockeras den tills arkivet är borta.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(sträng, sträng, bool, XarCompressionSettings)`

Skapa en enda inmatning inom arkivet.

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

`Parameters`

name string

Namnet på ingången.

sourcePath string

Vägen att filera för att komprimeras.

openImmediately bool

Det är sant, om du öppnar filen omedelbart, annars öppnar du filen på arkivspara.

compressionSettings XarCompressionSettings

De komprimeringsinställningar som används för att lägga till Aspose.Zip.Xar.XarEntry objekt.

`Returns`

XarEntry

Xar inträdesinstans.

`Examples`

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

`Remarks`

Innehållsnamnet anges endast inom parameter. filnamnet som anges i parameter påverkar inte innehållsnamnet.

Om filen öppnas omedelbart med parameter blockeras den tills arkivet är borta.

`Exceptions`

sourcePath’ is null.

Sökanden har inte behörig tillstånd att komma åt.

UnauthorizedAccessException

sourcePath’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken. - eller - Filnamn, som en del av name’, överstiger 100 symboler.

Tillgång till filen sourcePath’ vägras.

Den angivna sourcePath’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken. - eller - name’ är för lång för xar.

NotSupportedException

Filen i sourcePath’ innehåller en kolumn (:) i mitten av raden.

Det är omöjligt att ändra xar arkiv.

`CreateEntry(sträng, ström, XarCompressionSettings)`

Skapa en enda inmatning inom arkivet.

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

`Parameters`

name string

Namnet på ingången.

source Stream

Inträdesflöde för ingången.

compressionSettings XarCompressionSettings

De komprimeringsinställningar som används för att lägga till Aspose.Zip.Xar.XarEntry objekt.

`Returns`

XarEntry

Xar inträdesinstans.

`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 är omöjligt att ändra xar arkiv.

`DeleteEntry(XarEntry)`

Ta bort den första förekomsten av en viss inmatning från inmatningslistan.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Inträde att ta bort från listan inträde.

`Returns`

XarArchive

Xar inträdesinstans.

`Examples`

Här är hur du kan ta bort alla poster utom den sista:

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

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

public void Dispose()

`Dispose(Bool)`

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Oavsett om de förvaltade resurserna ska utplånas.

`ExtractToDirectory(Sträng)`

Extraherar alla filer i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Vägen till katalogen för att placera de extraherade filerna i.

`Examples`

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

`Remarks`

Om katalogen inte existerar kommer den att skapas.

`Exceptions`

Vägen är noll

Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägarna vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.

Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.

NotSupportedException

Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“C:”).

Vägen är en noll längd sträng, innehåller endast vitt utrymme, eller innehåller en eller flera invalid karaktärer. Du kan söka om invalid karaktärer genom att använda System.IO.Path.GetInvalidPathChars metod. -eller- vägen är förfäst med, eller innehåller, endast en kolonn karaktär (:).

Den katalog som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.

InvalidDataException

Arkivet är korrupt.

`Save(String, XarSaveOptions)`

Spara arkiv till den angivna destinationsfilen.

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

`Parameters`

destinationFileName string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

saveOptions XarSaveOptions

Alternativ för att spara xar arkiv med.

`Exceptions`

destinationFileName’ is null.

Det är omöjligt att ändra xar arkiv.

`Save(Ström, XarSaveOptions)`

Spara arkiv till den tillhandahållna strömmen.

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

`Parameters`

output Stream

Destination strömmar.

saveOptions XarSaveOptions

Alternativ för att spara xar arkiv med.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.