Class CpioArchive

Class CpioArchive

Název místa: Aspose.Zip.Cpio Sbírka: Aspose.Zip.dll (25.5.0)

Tato třída představuje cpio archivní soubor.

public class CpioArchive : IArchive, IDisposable

Inheritance

object CpioArchive

Implements

IArchive , IDisposable

Dědiční členové

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

Constructors

CpioArchive()

Začíná nový příklad třídy Aspose.Zip.Cpio.CpioArchive.

public CpioArchive()

Examples

Následující příklad ukazuje, jak komprimovat soubor.

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

CpioArchive(Stream)

Začíná nový příklad třídy Aspose.Zip.Cpio.CpioArchive a sestaví seznam vstupů, které lze extrahovat z archivu.

public CpioArchive(Stream sourceStream)

Parameters

sourceStream Stream

Zdroje archivu musí být vyhledateln.

Examples

Následující příklad ukazuje, jak extrahovat všechny vstupy do adresáře.

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

Remarks

Tento výrobce nevybaluje žádné vstupy. viz Aspose.Zip.Cpio.CpioEntry.Open metoda pro vybalován.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

CpioArchive(Stringová)

Začíná nový příklad třídy Aspose.Zip.Cpio.CpioArchive a sestaví seznam vstupů, které lze extrahovat z archivu.

public CpioArchive(string path)

Parameters

path string

Cesta do archivního souboru.

Examples

Následující příklad ukazuje, jak extrahovat všechny vstupy do adresáře.

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

Remarks

Tento výrobce nevybaluje žádné vstupy. viz Aspose.Zip.Cpio.CpioEntry.Open metoda pro vybalován.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>path’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky.

UnauthorizedAccessException

Přístup k souboru path" je odmítnut.

PathTooLongException

Uvedený path", název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows, trasy musí být méně než 248 znaků a názvy souboru musí být méně než 260 znak.

NotSupportedException

Soubor na path’ obsahuje kolonu (:) uprostřed řádku.

FileNotFoundException

Soubor nebyl nalezen.

DirectoryNotFoundException

Uvedená trasa je neplatná, např. být na nezapsaném pohonu.

IOException

Soubor je již otevřen.

Properties

Entries

Obdrží záznamy typu Aspose.Zip.Cpio.CpioEntry tvořící archiv.

public ReadOnlyCollection<cpioentry> Entries { get; }

Hodnota nemovitosti

ReadOnlyCollection < CpioEntry >

Methods

CreateEntries(Stringová, boolová)

Přidejte do archivu všechny soubory a adresáře opakovaně v daném adresáři.

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

Parameters

sourceDirectory string

Přihláška k kompresu.

includeRootDirectory bool

Ukazuje, zda zahrnout samotný kořenový adresář nebo ne.

Returns

CpioArchive

Vstupní instance Cpio.

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

Volající nemá požadované povolení k přístupu k sourceDirectory'.

ArgumentException

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

PathTooLongException

Například na platformách založených na Windows musí být trasy menší než 248 znaků a názvy souborů musí být menší než 260 znak.

IOException

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

CreateEntries(Úvodní stránka > Bool)

Přidejte do archivu všechny soubory a adresáře opakovaně v daném adresáři.

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

Parameters

directory DirectoryInfo

Přihláška k kompresu.

includeRootDirectory bool

Ukazuje, zda zahrnout samotný kořenový adresář nebo ne.

Returns

CpioArchive

Vstupní instance Cpio.

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

Volající nemá požadované povolení k přístupu k directory'.

IOException

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

CreateEntry(String, FileInfo a bool)

Vytvořte jediný vstup do archivu.

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

Parameters

name string

Název vstupu.

fileInfo FileInfo

Metadata souboru nebo složky, které mají být komprimovány.

openImmediately bool

Je pravda, že pokud otevřete soubor okamžitě, jinak otevřete soubor na archivní úspory.

Returns

CpioEntry

Vstupní instance Cpio.

Examples

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

Remarks

Pokud je soubor otevřen okamžitě s parametrem, blokuje se, dokud není archiv odstraněn.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(String, String a Bool)

Vytvořte jediný vstup do archivu.

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

Parameters

name string

Název vstupu.

sourcePath string

Způsob, jak dosáhnout komprese.

openImmediately bool

Je pravda, že pokud otevřete soubor okamžitě, jinak otevřete soubor na archivní úspory.

Returns

CpioEntry

Vstupní instance Cpio.

Examples

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

Remarks

Vstupní název je nastaven pouze v rámci parametru. název souboru uvedený v parametru nemá vliv na vstupní název.

Pokud je soubor otevřen okamžitě s parametrem, blokuje se, dokud není archiv odstraněn.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

Zákazník nemá požadované povolení k přístupu.

ArgumentException

code class=“paramref”>sourcePath’ je prázdný, obsahuje pouze bílé prostory, nebo obsahuje neplatné znaky. - nebo - Název souboru, jako součást name’, přesahuje 100 symbol.

UnauthorizedAccessException

Přístup k souboru sourcePath’ je odmítnut.

PathTooLongException

Například na platformách založených na Windows musí být trasy menší než 248 znaků a názvy souborů musí být menší než 260 znaků. - nebo - name’ je příliš dlouhý pro cpio.

NotSupportedException

Soubor na sourcePath’ obsahuje kolonu (:) uprostřed řádku.

CreateEntry(Stretch , Stream)

Vytvořte jediný vstup do archivu.

public CpioEntry CreateEntry(string name, Stream source)

Parameters

name string

Název vstupu.

source Stream

Vstupní proud pro vstup.

Returns

CpioEntry

Vstupní instance Cpio.

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)

Odstraňuje první výskyt konkrétního vstupu z seznamu vstup.

public CpioArchive DeleteEntry(CpioEntry entry)

Parameters

entry CpioEntry

Vstup k odstranění z seznamu vstup.

Returns

CpioArchive

Vstupní instance Cpio.

Examples

Zde je, jak můžete odstranit všechny příspěvky s výjimkou posledn:

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)

Odstraňuje vstup z seznamu vstupů indexem.

public CpioArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Nulový index vstupu, který je třeba odstranit.

Returns

CpioArchive

Archiv s vstupem byl vymazán.

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

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

public void Dispose()

Dispose(Bolíček)

Provádí aplikativně definované úkoly spojené s uvolňováním, uvolňováním nebo resetováním neupravených zdroj.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Je nutné zlikvidovat spravované zdroje.

ExtractToDirectory(Stringová)

Vytahuje všechny soubory v archivu do poskytnutého adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Cesta do adresáře umístit extrahované soubory do.

Examples

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

Remarks

Pokud adresář neexistuje, bude vytvořen.

Exceptions

ArgumentNullException

Cesta je nulová

PathTooLongException

Zadaná trasa, název souboru nebo obojí přesahuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasa menší než 248 znaků a název souboru musí být menší než 260 znak.

SecurityException

Návštěvník nemá požadované povolení k přístupu k stávajícímu adresáři.

NotSupportedException

Pokud adresář neexistuje, trasa obsahuje znak kolonu (:) který není součástí štítku disku (“C:”).

ArgumentException

Path je řetězec nulové délky, obsahuje pouze bílý prostor, nebo obsahuje jeden nebo více neplatných znaků.Můžete požádat o neplatné znaky pomocí metody System.IO.Path.GetInvalidPathChars. -or- cesta je předem nastaven s, nebo obsahuje, pouze znak kolon (:).

IOException

dek určený cestou je soubor. -or- Název sítě není znám.

Save(Třída, CpioFormat)

Shromažďuje archiv na poskytnutý cílový soubor.

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

Parameters

destinationFileName string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

Examples

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

Remarks

Je možné uložit archiv na stejnou cestu, jakou byl stažen z. Nicméně, to se nedoporučuje, protože tento přístup používá kopírování do dočasného souboru.

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

Uvedený destinationFileName’, název souboru, nebo oba překračují maximální délku definovanou systémem. Například na platformách založených na Windows musí být trasy menší než 248 znaků a název souboru musí být menší než 260 znak.

DirectoryNotFoundException

Uvedený destinationFileName’ je neplatný (např. je na nezapsaném disku).

IOException

Při otevření souboru došlo k chybě I/O.

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(Přívěs, CpioFormat)

Ušetří archiv na poskytnutém toku.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

Examples

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

Remarks

Musí být psatelná.

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(Přívěs, CpioFormat)

Ušetří archiv do toku pomocí gzip komprese.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Musí být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Třída, CpioFormat)

Ušetří archiv souboru podle cesty s gzip kompres.

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

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Záchranná komprese(Přívěs, CpioFormat)

Ušetřete archiv do toku pomocí komprese LZMA.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Musí být psatelná.

Důležité: cpio archiv je sestaven a poté komprimován v rámci této metody, jeho obsah je udržován vnitřn.

Záchranná komprese(Třída, CpioFormat)

Uloží archiv do souboru po cestě s lzma kompres.

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

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Důležité: cpio archiv je sestaven a poté komprimován v rámci této metody, jeho obsah je udržován vnitřn.

SaveLzipped(Přívěs, CpioFormat)

Ušetří archiv do toku s lzip kompres.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Musí být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Třída, CpioFormat)

Ušetří archiv do souboru na cestě s lzip kompres.

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

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

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)

Ušetří archiv do toku s xz kompres.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

settings XzArchiveSettings

Soubor nastavení konkrétního xz archivu: velikost slovníku, velikost bloků, typ kontroly.

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

Průtok musí být písemný.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Třída, CpioFormat, XzArchiveSettings)

Ušetří archiv na cestě po cestě s xz kompres.

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

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

settings XzArchiveSettings

Soubor nastavení konkrétního xz archivu: velikost slovníku, velikost bloků, typ kontroly.

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

Slevová komprese(Přívěs, CpioFormat)

Ušetří archiv do toku s kompresí Z.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Musí být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Slevová komprese(Třída, CpioFormat)

Ušetří archiv na cestě po cestě s kompresí Z.

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

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

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(Přívěs, CpioFormat)

Ušetří archiv do toku pomocí standardní komprese.

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

Parameters

output Stream

Destinace v toku.

cpioFormat CpioFormat

Definuje formát cpio header.

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

Musí být psatelná.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Třída, CpioFormat)

Ušetří archiv souboru podle cesty se standardní kompres.

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

Parameters

path string

Pokud specifikovaný název souboru ukazuje na existující soubor, bude přepisován.

cpioFormat CpioFormat

Definuje formát cpio header.

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");
    }
}
 Čeština