Class CpioArchive

Class CpioArchive

Navne til: Aspose.Zip.Cpio Sammensætning: Aspose.Zip.dll (25.5.0)

Denne klasse repræsenterer cpio arkiv filer.

public class CpioArchive : IArchive, IDisposable

Inheritance

object CpioArchive

Implements

IArchive , IDisposable

De arvede medlemmer

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

CpioArchive()

Initialiserer en ny instans af Aspose.Zip.Cpio.CpioArchive klasse.

public CpioArchive()

Examples

Følgende eksempel viser, hvordan man komprimerer en fil.

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

CpioArchive(Stream)

Initialiserer en ny instans af Aspose.Zip.Cpio.CpioArchive klasse og komponerer en indgangsliste, der kan uddrages fra arkivet.

public CpioArchive(Stream sourceStream)

Parameters

sourceStream Stream

Arkivets kilde. det skal være søgbart.

Examples

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

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

Remarks

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

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

CpioArchive(String)

Initialiserer en ny instans af Aspose.Zip.Cpio.CpioArchive klasse og komponerer en indgangsliste, der kan uddrages fra arkivet.

public CpioArchive(string path)

Parameters

path string

Vejen til arkiveret.

Examples

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

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

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

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.

DirectoryNotFoundException

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

IOException

Filen er allerede åben.

Properties

Entries

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

public ReadOnlyCollection<cpioentry> Entries { get; }

Ejendomsværdi

ReadOnlyCollection < CpioEntry >

Methods

CreateEntries(String og Bool)

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

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

Parameters

sourceDirectory string

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

Returns

CpioArchive

Indtastning af indtastning af indtastning.

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

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

ArgumentException

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

PathTooLongException

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.

IOException

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

CreateEntries(Anmeldelse: Bool)

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

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

Parameters

directory DirectoryInfo

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

Returns

CpioArchive

Indtastning af indtastning af indtastning.

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

ArgumentNullException

directory’ is null.

SecurityException

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

IOException

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

CreateEntry(String, FileInfo og Bool)

Skab en enkelt indgang i arkivet.

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

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.

Returns

CpioEntry

Indtastning af indtastning af indtastning.

Examples

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

Remarks

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

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(String, String og Bool)

Skab en enkelt indgang i arkivet.

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

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.

Returns

CpioEntry

Indtastning af indtastning af indtastning.

Examples

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

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

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Tilgang til filen sourcePath’ er nægtet.

PathTooLongException

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

NotSupportedException

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

CreateEntry(Strøm, Strøm)

Skab en enkelt indgang i arkivet.

public CpioEntry CreateEntry(string name, Stream source)

Parameters

name string

Navnet på indgangen.

source Stream

Indtægtsstrøm for indtægten.

Returns

CpioEntry

Indtastning af indtastning af indtastning.

Examples

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

Exceptions

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

name’ is empty.

DeleteEntry(CpioEntry)

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

public CpioArchive DeleteEntry(CpioEntry entry)

Parameters

entry CpioEntry

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

Returns

CpioArchive

Indtastning af indtastning af indtastning.

Examples

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

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

Exceptions

ArgumentNullException

entry’ is null.

DeleteEntry(Int)

Fjern indtægten fra indtægtslisten ved indeks.

public CpioArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Det nulbaserede indeks af indtægten skal fjernes.

Returns

CpioArchive

Arkivet med indgangen er slettet.

Examples

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

Exceptions

ArgumentOutOfRangeException

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

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 CpioArchive("archive.cpio")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Hvis katalogen ikke eksisterer, vil den blive oprettet.

Exceptions

ArgumentNullException

Vejen er null

PathTooLongException

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.

SecurityException

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

NotSupportedException

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

ArgumentException

Path er en nullængde string, indeholder kun hvid plads, eller indeholder en eller flere invalide tegn. Du kan spørge for invalide tegn ved hjælp af System.IO.Path.GetInvalidPathChars metode. -eller- vej er forhåndsbestemt med, eller indeholder, kun en kolon karakter (:).

IOException

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

Save(String, CpioFormat)

Sparer arkiver til en bestemmelsesfil, der er leveret.

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

Parameters

destinationFileName string

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

cpioFormat CpioFormat

Definition af cpio header format.

Examples

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

Remarks

Det er muligt at gemme et arkiv på samme vej, som det blev lastet fra. dog anbefales dette ikke, fordi denne tilgang bruger kopiering til en midlertidig fil.

Exceptions

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

Den angivne destinationFileName’, filnavn, eller begge overskrider 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.

DirectoryNotFoundException

Den angivne destinationFileName’ er ugyldig (f.eks. den er på en ikke-mapped disk).

IOException

En I/O-fejl opstod under åbningen af filen.

UnauthorizedAccessException

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.

NotSupportedException

destinationFileName’ is in an invalid format.

Save(Strøm, CpioFormat)

Sparer arkiver til den leverede strøm.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af 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

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

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)

Sparer arkiver til strømmen med gzip-kompression.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af 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

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(String, CpioFormat)

Sparer arkiver til filen ved hjælp af gzip-kompression.

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

Parameters

path string

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

cpioFormat CpioFormat

Definition af 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");
    }
}

Sikkerhed komprimeret(Strøm, CpioFormat)

Sparer arkivet til strømen med LZMA-kompression.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af 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

Det skal være skriftligt.

Vigtigt: cpio arkiver er sammensat og komprimeret inden for denne metode, dens indhold bevares internalt.

Sikkerhed komprimeret(String, CpioFormat)

Sparer arkivet til filen ved hjælp af lzma kompression.

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

Parameters

path string

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

cpioFormat CpioFormat

Definition af 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

Vigtigt: cpio arkiver er sammensat og komprimeret inden for denne metode, dens indhold bevares internalt.

SaveLzipped(Strøm, CpioFormat)

Sparer arkiver til strømen med lzip-kompression.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af 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

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(String, CpioFormat)

Sparer arkiver til filen ved hjælp af lzip-kompression.

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

Parameters

path string

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

cpioFormat CpioFormat

Definition af 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(Strøm, CpioFormat, XzArchiveSettings)

Sparer arkiver til strømen med xz-kompression.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af cpio header format.

settings XzArchiveSettings

Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.

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 skal være skriftlig.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(String, CpioFormat, XzArchiveSettings)

Sparer arkiver til vejen ved vejen med xz kompression.

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

Parameters

path string

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

cpioFormat CpioFormat

Definition af cpio header format.

settings XzArchiveSettings

Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.

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");
    }
}

Beskyttelse komprimeret(Strøm, CpioFormat)

Sparer arkiver til strømen med Z-kompression.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af 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

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Beskyttelse komprimeret(String, CpioFormat)

Sparer arkiver til vejen ved vejen med Z-kompression.

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

Parameters

path string

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

cpioFormat CpioFormat

Definition af 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)

Sparer arkiver til strømen med Zstandard kompression.

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

Parameters

output Stream

Destinationstrøm.

cpioFormat CpioFormat

Definition af 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

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(String, CpioFormat)

Sparer arkiver til filen efter vej med Zstandard kompression.

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

Parameters

path string

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

cpioFormat CpioFormat

Definition af 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.SaveZstandard("result.cpio.zst");
    }
}
 Dansk