Class CpioArchive

Class CpioArchive

A név: Aspose.Zip.Cpio Összefoglaló: Aspose.Zip.dll (25.5.0)

Ez az osztály képviseli a cpio archív fájlt.

public class CpioArchive : IArchive, IDisposable

Inheritance

object CpioArchive

Implements

IArchive , IDisposable

Örökletes tagok

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

Constructors

CpioArchive()

Kezdeményez egy új példát az Aspose.Zip.Cpio.CpioArchive osztály.

public CpioArchive()

Examples

Az alábbi példa azt mutatja, hogyan kell tömöríteni egy fájlt.

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

CpioArchive(Stream)

Kezdeményez egy új példát az Aspose.Zip.Cpio.CpioArchive osztály és készíti a bejegyzési listát lehet kivonni az archívumból.

public CpioArchive(Stream sourceStream)

Parameters

sourceStream Stream

Az archívum forrása. meg kell keresni.

Examples

Az alábbi példa azt mutatja, hogyan lehet kivonni az összes bejegyzéseket egy címkébe.

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

Remarks

Ez az építő nem törli a bejegyzést. lásd Aspose.Zip.Cpio.CpioEntry.Open módszer a törléshez.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

CpioArchive(A string)

Kezdeményez egy új példát az Aspose.Zip.Cpio.CpioArchive osztály és készíti a bejegyzési listát lehet kivonni az archívumból.

public CpioArchive(string path)

Parameters

path string

Az út az archív fájlhoz.

Examples

Az alábbi példa azt mutatja, hogyan lehet kivonni az összes bejegyzéseket egy címkébe.

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

Remarks

Ez az építő nem törli a bejegyzést. lásd Aspose.Zip.Cpio.CpioEntry.Open módszer a törléshez.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési engedélygel.

ArgumentException

A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.

UnauthorizedAccessException

A path" fájlhoz való hozzáférés elutasításra kerül.

PathTooLongException

A meghatározott path", fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.

NotSupportedException

A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.

FileNotFoundException

A fájlt nem találták meg.

DirectoryNotFoundException

A kijelölt út nem érvényes, például egy mappátlan vezérlésen.

IOException

A fájl már nyitva van.

Properties

Entries

Kap bejegyzéseit Aspose.Zip.Cpio.CpioEntry típus alkotja az archívumot.

public ReadOnlyCollection<cpioentry> Entries { get; }

ingatlan értéke

ReadOnlyCollection < CpioEntry >

Methods

CreateEntries(Szilveszter, Bool)

Hozzáadja az archívumhoz az összes fájlt és címkéket az adott címkében ismétlődően.

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

Parameters

sourceDirectory string

A kompressziós kézikönyv.

includeRootDirectory bool

Megmutatja, hogy magában foglalja-e a gyökérdirektorát vagy sem.

Returns

CpioArchive

Cpió belépési beállítás.

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

A hívó nem rendelkezik a sourceDirectory’hoz való hozzáféréshez szükséges engedélygel.

ArgumentException

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

PathTooLongException

A meghatározott útvonal, a fájl neve vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájl neve kevesebbnek kell lennie, mint 260 karakter.

IOException

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

CreateEntries(Részletesebben Bool, Bool)

Hozzáadja az archívumhoz az összes fájlt és címkéket az adott címkében ismétlődően.

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

Parameters

directory DirectoryInfo

A kompressziós kézikönyv.

includeRootDirectory bool

Megmutatja, hogy magában foglalja-e a gyökérdirektorát vagy sem.

Returns

CpioArchive

Cpió belépési beállítás.

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

A hívó nem rendelkezik a directory’hoz való hozzáféréshez szükséges engedélygel.

IOException

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

CreateEntry(Részletesebben FileInfo, Bool)

Hozzon létre egy egységes bejegyzést az archívumban.

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

Parameters

name string

A bejárat neve.

fileInfo FileInfo

A fájl vagy a mappa metadata nyomtatásra kerül.

openImmediately bool

Igaz, ha azonnal megnyitja a fájlt, különben megnyitja a fájlt az archív mentés.

Returns

CpioEntry

Cpió belépési beállítás.

Examples

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

Remarks

Ha a fájl azonnal megnyílik a paraméterrel, akkor az archívum megszűnik.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(szál, szál, szál)

Hozzon létre egy egységes bejegyzést az archívumban.

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

Parameters

name string

A bejárat neve.

sourcePath string

A nyomtatás útja a nyomtatáshoz.

openImmediately bool

Igaz, ha azonnal megnyitja a fájlt, különben megnyitja a fájlt az archív mentés.

Returns

CpioEntry

Cpió belépési beállítás.

Examples

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

Remarks

A paraméterben megadott fájl neve nem befolyásolja a bejegyzés nevét.

Ha a fájl azonnal megnyílik a paraméterrel, akkor az archívum megszűnik.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési engedélygel.

ArgumentException

A sourcePath’ üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz. - vagy - A fájl neve, a name’ részeként, meghaladja a 100 szimbólumot.

UnauthorizedAccessException

A sourcePath” fájlhoz való hozzáférést elutasítják.

PathTooLongException

A meghatározott sourcePath’, fájl neve, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlneveknek kevesebbnek kell lennie, mint 260 karakter. - vagy - name’ túl hosszú a cpio számára.

NotSupportedException

A sourcePath’ fájl tartalmaz egy oszlopot (:) a sor közepén.

CreateEntry(Áramlás, Stream)

Hozzon létre egy egységes bejegyzést az archívumban.

public CpioEntry CreateEntry(string name, Stream source)

Parameters

name string

A bejárat neve.

source Stream

A belépési áram a belépéshez.

Returns

CpioEntry

Cpió belépési beállítás.

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)

Eltávolítja egy adott bejegyzés első megjelenését a bejegyzéslistából.

public CpioArchive DeleteEntry(CpioEntry entry)

Parameters

entry CpioEntry

A bejegyzést a bejegyzési listából kell eltávolítani.

Returns

CpioArchive

Cpió belépési beállítás.

Examples

Íme, hogyan lehet eltávolítani az összes bejegyzés kivéve az utolsó:

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)

Távolítsa el a bejegyzést a bejegyzési listából index szerint.

public CpioArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

A nulla-alapú index a bejárat eltávolítására.

Returns

CpioArchive

Az archívumot a bejárattal törölték.

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

Alkalmazás-meghatározott feladatokat végez, amelyek a nem kezelt erőforrások felszabadításával, felszabadításával vagy újrahasznosításával kapcsolatosak.

public void Dispose()

Dispose(Bóli)

Alkalmazás-meghatározott feladatokat végez, amelyek a nem kezelt erőforrások felszabadításával, felszabadításával vagy újrahasznosításával kapcsolatosak.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

A kezelt erőforrások megszüntetésére van szükség.

ExtractToDirectory(A string)

Az archívumban lévő összes fájlt a megadott katalógusba kell kivonni.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Az út a címkéhez, hogy a kivont fájlokat helyezze el.

Examples

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

Remarks

Ha a katalógus nem létezik, akkor létre kell hozni.

Exceptions

ArgumentNullException

Az út null

PathTooLongException

A meghatározott útvonal, a fájl neve vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalaknak kevesebbnek kell lenniük, mint 248 karakter, és a fájlneveknek kevesebbnek kell lenniük, mint 260 karakter.

SecurityException

A hívó nem rendelkezik a meglévő címkéhez való hozzáféréshez szükséges engedéllyel.

NotSupportedException

Ha a kézikönyv nem létezik, az útvonal tartalmaz egy csomópont karaktert (:) amely nem része a lemez címkéjének (“C:”).

ArgumentException

Az útvonal egy nulla hosszúságú vonal, csak fehér helyet tartalmaz, vagy egy vagy több nem érvényes karaktert tartalmaz. Nem érvényes karaktereket kérhet a System.IO.Path.GetInvalidPathChars módszerrel. -or- útvonal előre rögzítve van, vagy csak egy csomó karaktert tartalmaz (:).

IOException

Az útvonal által meghatározott kézikönyv egy fájl. -or- A hálózati név nem ismert.

Save(Részletesebben CpioFormat)

Adja meg az archívumot a megadott célfájlra.

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

Parameters

destinationFileName string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

Examples

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

Remarks

Az archívumot ugyanolyan úton lehet menteni, mint amilyenről letöltött. azonban ez nem ajánlott, mert ez a megközelítés egy ideiglenes fájlra másolja.

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

A meghatározott destinationFileName’, fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.

DirectoryNotFoundException

A meghatározott destinationFileName’ nem érvényes (például egy nem mappált lemezre található).

IOException

Az I/O hiba bekövetkezett a fájl megnyitásakor.

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(Áramlat, CpioFormat)

Megtakarítja az archívumot a megadott áramláshoz.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

Examples

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

Remarks

írásszerűnek kell lennie.

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(Áramlat, CpioFormat)

Megtakarítja az archívumot a gzip kompresszióval.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

írásszerűnek kell lennie.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Részletesebben CpioFormat)

Az archívumok mentése a fájlhoz a gzip-kompresszióval.

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

Parameters

path string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

Megtakarítás nyomtatott(Áramlat, CpioFormat)

Megtakarítja az archívumot az áramláshoz az LZMA tömörítéssel.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

írásszerűnek kell lennie.

Fontos: a cpio archívumot összeállítják, majd ebben a módszerben tömörítik, tartalmát belsőleg tartják.

Megtakarítás nyomtatott(Részletesebben CpioFormat)

Az archívum mentése a fájlhoz az útvonalon az lzma tömörítéssel.

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

Parameters

path string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

Fontos: a cpio archívumot összeállítják, majd ebben a módszerben tömörítik, tartalmát belsőleg tartják.

SaveLzipped(Áramlat, CpioFormat)

Megtakarítja az archívumot az áramláshoz az lzip-kompresszióval.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

írásszerűnek kell lennie.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Részletesebben CpioFormat)

Az archívumok mentése a fájlhoz az útvonalon az lzip tömörítéssel.

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

Parameters

path string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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(Áramlat, CpioFormat, XzArchiveSettings)

Megtakarítja az archívumot az áramláshoz xz tömörítéssel.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

settings XzArchiveSettings

A beállítások egyedi xz archívum: szótár mérete, blokk mérete, ellenőrzési típus.

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

Az áramnak írásszerűnek kell lennie.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Szalag, CpioFormat, XzArchiveSettings)

Megtakarítja az archívumot az útvonalon az xz tömörítéssel.

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

Parameters

path string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

settings XzArchiveSettings

A beállítások egyedi xz archívum: szótár mérete, blokk mérete, ellenőrzési típus.

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

Összefoglaló(Áramlat, CpioFormat)

Megtakarítja az archívumot a Z-kompresszióval.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

írásszerűnek kell lennie.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Összefoglaló(Részletesebben CpioFormat)

Megtakarítja az archívumot az útvonalon a Z-kompresszióval.

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

Parameters

path string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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(Áramlat, CpioFormat)

Megtakarítja az archívumot az áramláshoz a Zstandard kompresszióval.

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

Parameters

output Stream

A cél áramlása.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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

írásszerűnek kell lennie.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Részletesebben CpioFormat)

Az archívumok mentése a fájlhoz az úton a Zstandard kompresszióval.

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

Parameters

path string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

cpioFormat CpioFormat

Meghatározza a cpio header formátumot.

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