Class CpioArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

`CpioArchive(Sträng)`

Initialiserar en ny instans av Aspose.Zip.Cpio.CpioArchive-klassen och utgör en ingångslista som kan extraheras från arkivet.

public CpioArchive(string path)

`Parameters`

path string

Vägen till arkivfilen.

`Examples`

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

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

`Remarks`

Denna konstruktör avpackar inte någon inmatning. Se Aspose.Zip.Cpio.CpioEntry.Öppna metoden 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.

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.

DirectoryNotFoundException

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.

`Properties`

`Entries`

Få inmatningar av Aspose.Zip.Cpio.CpioEntry typ som utgör arkivet.

public ReadOnlyCollection<cpioentry> Entries { get; }

`Fastighetsvärde`

ReadOnlyCollection ochlt; CpioEntry >

`Methods`

`CreateEntries(String och bool)`

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

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

`Parameters`

sourceDirectory string

katalog för komprimering.

includeRootDirectory bool

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

`Returns`

Cpio inträde instans.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(cpioFile);
    }
}

`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(Föregående inlägg: Bool)`

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

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

`Parameters`

directory DirectoryInfo

katalog för komprimering.

includeRootDirectory bool

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

`Returns`

Cpio inträde instans.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(cpioFile);
    }
}

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

Skapa en enda inmatning inom arkivet.

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

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

`Returns`

CpioEntry

Cpio inträde instans.

`Examples`

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

`Remarks`

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

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(String, String och Bool)`

Skapa en enda inmatning inom arkivet.

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

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

`Returns`

CpioEntry

Cpio inträde instans.

`Examples`

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

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

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

`CreateEntry(Ström, ström)`

Skapa en enda inmatning inom arkivet.

public CpioEntry CreateEntry(string name, Stream source)

`Parameters`

name string

Namnet på ingången.

source Stream

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

`Returns`

CpioEntry

Cpio inträde instans.

`Examples`

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

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(CpioEntry)`

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

public CpioArchive DeleteEntry(CpioEntry entry)

`Parameters`

entry CpioEntry

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

`Returns`

Cpio inträde instans.

`Examples`

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

using (var archive = new CpioArchive("archive.cpio"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputCpioFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(int)`

Ta bort inmatningen från inmatningslistan per index.

public CpioArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Nollbaserad index för inmatning att ta bort.

`Returns`

ArgumentOutOfRangeException

Arkivet med ingången raderas.

`Examples`

using (var archive = new CpioArchive("two_files.cpio"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.cpio");
}

`Exceptions`

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

`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 CpioArchive("archive.cpio")) 
{ 
   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.

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

Path ä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.

`Save(Sträng, CpioFormat)`

Spara arkiv till en avsedd fil som tillhandahålls.

public void Save(string destinationFileName, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

destinationFileName string

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

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

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

`Remarks`

Det är möjligt att spara ett arkiv på samma väg som det laddades från. Detta rekommenderas dock inte eftersom denna metod använder kopiering till en tillfällig fil.

`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

Den angivna destinationFileName’, 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.

Den angivna destinationFileName’ är ogiltig (t.ex. den är på en outmappad enhet).

UnauthorizedAccessException

Ett I/O-fel inträffade när du öppnade filen.

destinationFileName’Specified a file is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

destinationFileName’ is in an invalid format.

`Save(Ström, CpioFormat)`

Spara arkiv till den tillhandahållna strömmen.

public void Save(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(cpioFile);
    }
}

`Remarks`

Måste vara skribar.

`Exceptions`

output’ is null.

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in cpioFormat’ due to format restrictions.

`SaveGzipped(Ström, CpioFormat)`

Spara arkiv till strömmen med gzip-kompression.

public void SaveGzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

`Remarks`

Måste vara skribar.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveGzipped(Sträng, CpioFormat)`

Spara arkiv till filen per väg med gzip-kompression.

public void SaveGzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.gz");
    }
}

`Hålls komprimerad(Ström, CpioFormat)`

Spara arkivet till strömmen med LZMA-kompression.

public void SaveLZMACompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

`Remarks`

Måste vara skribar.

Viktigt: cpio arkiv består sedan komprimeras inom denna metod, dess innehåll hålls intern.

`Hålls komprimerad(Sträng, CpioFormat)`

Spara arkivet till filen med lzma-kompression.

public void SaveLZMACompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.cpio.lzma");
    }
}

`Remarks`

Viktigt: cpio arkiv består sedan komprimeras inom denna metod, dess innehåll hålls intern.

`SaveLzipped(Ström, CpioFormat)`

Spara arkiv till strömmen med lzip-kompression.

public void SaveLzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

`Remarks`

Måste vara skribar.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLzipped(Sträng, CpioFormat)`

Spara arkiv till filen på väg med lzip-kompression.

public void SaveLzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.lz");
    }
}

`SaveXzCompressed(Stream, CpioFormat, XzArchiveSettings)`

Spara arkiv till strömmen med xz-kompression.

public void SaveXzCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

settings XzArchiveSettings

Set av specifika xz arkiv inställningar: ordbokstorlek, blockstorlek, kontroll typ.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

`Remarks`

Strömmen måste vara skribar.

`Exceptions`

output’ is null.

output’ is not writable.

`SaveXzCompressed(sträng, CpioFormat, XzArchiveSettings)`

Spara arkiv till vägen genom vägen med xz-kompression.

public void SaveXzCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

`Parameters`

path string

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

cpioFormat CpioFormat

Definiera cpio header format.

settings XzArchiveSettings

Set av specifika xz arkiv inställningar: ordbokstorlek, blockstorlek, kontroll typ.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.cpio.xz");
    }
}

`Säkerhetskomprimerad(Ström, CpioFormat)`

Spara arkiv till strömmen med Z-kompression.

public void SaveZCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

`Remarks`

Måste vara skribar.

`Exceptions`

output’ is null.

output’ is not writable.

`Säkerhetskomprimerad(Sträng, CpioFormat)`

Spara arkiv till vägen genom vägen med Z-kompression.

public void SaveZCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.cpio.Z");
    }
}

`SaveZstandard(Ström, CpioFormat)`

Spara arkiv till strömmen med standardkompression.

public void SaveZstandard(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

Destination strömmar.

cpioFormat CpioFormat

Definiera cpio header format.

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

`Remarks`

Måste vara skribar.

`Exceptions`

output’ is null.