Class CpioArchive
Der Name: Aspose.Zip.Cpio Versammlung: Aspose.Zip.dll (25.5.0)
Diese Klasse repräsentiert cpio-Archivdatei.
public class CpioArchive : IArchive, IDisposableInheritance
Implements
Vererbte Mitglieder
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
CpioArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Cpio.CpioArchive Klasse.
public CpioArchive()Examples
Das folgende Beispiel zeigt, wie man eine Datei komprimiert.
using (var archive = new CpioArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.cpio");
}CpioArchive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.Cpio.CpioArchive Klasse und komponiert eine Einträge, die aus dem Archiv extrahiert werden kann.
public CpioArchive(Stream sourceStream)Parameters
sourceStream Stream
Die Quelle des Archivs. es muss nachfindlich sein.
Examples
Das folgende Beispiel zeigt, wie man alle Beiträge in ein Katalog extrahiert.
using (var archive = new CpioArchive(File.OpenRead("archive.cpio")))
{
archive.ExtractToDirectory("C:\extracted");
}Remarks
Dieser Konstruktor entpackt keine Einträge. siehe Aspose.Zip.Cpio.CpioEntry.Open Methode für Entpacken.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid cpio archive.
CpioArchive(String)
Initialisiert eine neue Instanz der Aspose.Zip.Cpio.CpioArchive Klasse und komponiert eine Einträge, die aus dem Archiv extrahiert werden kann.
public CpioArchive(string path)Parameters
path string
Der Weg zum Archiv.
Examples
Das folgende Beispiel zeigt, wie man alle Beiträge in ein Katalog extrahiert.
using (var archive = new CpioArchive("archive.cpio"))
{
archive.ExtractToDirectory("C:\extracted");
}Remarks
Dieser Konstruktor entpackt keine Einträge. siehe Aspose.Zip.Cpio.CpioEntry.Open Methode für Entpacken.
Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
Die Datei ist nicht gefunden.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
Properties
Entries
Er erhält Beiträge von Aspose.Zip.Cpio.CpioEntry Typ, der das Archiv darstellt.
public ReadOnlyCollection<cpioentry> Entries { get; }Eigentumswert
ReadOnlyCollection &undlt; CpioEntry >
Methods
CreateEntries(String und Bool)
Add to the archive all the files and directories recurrently in the given directory. - Add to the archive all the files and directories recurrently in the given directory.
public CpioArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Verzeichnis zum Komprimieren.
includeRootDirectory bool
Angibt, ob die Root-Dokumentation selbst enthalten ist oder nicht.
Returns
Cpio Eintrittsinstanz.
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.
Der Anrufgeber hat nicht die erforderliche Erlaubnis zum Zugriff auf sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(VerzeichnisInfo, Bool)
Add to the archive all the files and directories recurrently in the given directory. - Add to the archive all the files and directories recurrently in the given directory.
public CpioArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Verzeichnis zum Komprimieren.
includeRootDirectory bool
Angibt, ob die Root-Dokumentation selbst enthalten ist oder nicht.
Returns
Cpio Eintrittsinstanz.
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.
Der Anrufgeber hat nicht die erforderliche Erlaubnis zum Zugriff auf directory'.
directory’ stands for a file, not for a directory.
CreateEntry(String, FileInfo und Bool)
Erstellen Sie einen einzigen Eingang innerhalb des Archivs.
public CpioEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Der Name des Eingangs.
fileInfo FileInfo
Die Metadaten von Datei oder Ordner zu komprimieren.
openImmediately bool
Wahrlich, wenn Sie die Datei sofort öffnen, öffnen Sie sonst die Datei auf Archiv-Speicher.
Returns
Cpio Eintrittsinstanz.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new CpioArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.cpio");
}Remarks
Wenn die Datei sofort mit dem Parameter geöffnet wird, wird sie blockiert, bis das Archiv gelöscht wird.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String und Bool)
Erstellen Sie einen einzigen Eingang innerhalb des Archivs.
public CpioEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Der Name des Eingangs.
sourcePath string
Der Weg zum Datei zu komprimieren.
openImmediately bool
Wahrlich, wenn Sie die Datei sofort öffnen, öffnen Sie sonst die Datei auf Archiv-Speicher.
Returns
Cpio Eintrittsinstanz.
Examples
using (var archive = new CpioArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.cpio");
}Remarks
Der im Parameter angegebenen Dateiname beeinflusst nicht den Eingangsnamen.
Wenn die Datei sofort mit dem Parameter geöffnet wird, wird sie blockiert, bis das Archiv gelöscht wird.
Exceptions
sourcePath’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die sourcePath’ ist leer, enthält nur weiße Räume, oder enthält ungültige Zeichen. - oder - Dateiname, als Teil der name’, übersteigt 100 Symbole.
Der Zugriff auf die Datei sourcePath’ wird abgelehnt.
Die angegebenen sourcePath’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein. - oder - name’ ist zu lang für cpio.
Die Datei bei sourcePath’ enthält eine Kolonne (:) in der Mitte der Zeile.
CreateEntry(Strömung, Stream)
Erstellen Sie einen einzigen Eingang innerhalb des Archivs.
public CpioEntry CreateEntry(string name, Stream source)Parameters
name string
Der Name des Eingangs.
source Stream
Der Eingangstrom für den Eingang.
Returns
Cpio Eintrittsinstanz.
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)
Entfernen Sie das erste Auftreten eines bestimmten Eintrags aus der Eintragsliste.
public CpioArchive DeleteEntry(CpioEntry entry)Parameters
entry CpioEntry
Eintritt zu entfernen aus der Eintrittsliste.
Returns
Cpio Eintrittsinstanz.
Examples
Hier ist, wie Sie alle Beiträge mit Ausnahme des letzten entfernen können:
using (var archive = new CpioArchive("archive.cpio"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputCpioFile);
}Exceptions
entry’ is null.
DeleteEntry(Int)
Entfernen Sie den Eingang aus der Eingangsliste durch Index.
public CpioArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Der null-basierte Index des Eingangs zu entfernen.
Returns
Das Archiv mit dem Eingang gelöscht.
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()
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
public void Dispose()Dispose(Bool)
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Ob verwaltete Ressourcen abgeschieden werden sollten.
ExtractToDirectory(String)
Entfernen Sie alle Dateien im Archiv in das angebotene Katalog.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Der Weg zum Katalog, um die extrahierten Dateien in.
Examples
using (var archive = new CpioArchive("archive.cpio"))
{
archive.ExtractToDirectory("C:\extracted");
}Remarks
Wenn das Katalog nicht existiert, wird es erstellt.
Exceptions
Der Weg ist null
Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Der Anrufgeber hat nicht die erforderliche Erlaubnis, das bestehende Direktorium zuzugreifen.
Wenn das Direktorium nicht existiert, enthält eine Strecke einen Charakter (:) der nicht Teil eines Labels ist (“C:”).
Path ist eine nulllänge String, enthält nur weiße Räume, oder enthält einen oder mehrere invalid Charaktere. Sie können für invalid Charaktere anfordern, indem Sie die System.IO.Path.GetInvalidPathChars Methode verwenden. -or- Path ist mit, oder enthält, nur ein Kolon Charakter (:).
Die durch den Weg angegebenen Katalog ist eine Datei. -or- Der Netzwerkname ist nicht bekannt.
Save(String, CpioFormat)
Speichern Sie das Archiv zu einem bereitgestellten Zieldatei.
public void Save(string destinationFileName, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
destinationFileName string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das Cpio Header Format.
Examples
using (var archive = new CpioArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.cpio");
}Remarks
Es ist möglich, ein Archiv auf dem gleichen Weg zu speichern, wie es heruntergeladen wurde. jedoch wird dies nicht empfohlen, weil dieser Ansatz Kopieren zu einer vorübergehenden Datei verwendet.
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.
Die angegebenen destinationFileName’, Dateiname, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Spuren weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen sein.
Die angegebenen destinationFileName’ ist ungültig (z. B. auf einem unmapped-Drive).
Ein I/O-Fehler kam beim Öffnen der Datei auf.
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(Stream, CpioFormat)
Speichern Sie Archive für den bereitgestellten Strom.
public void Save(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das 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
Es muss geschrieben werden.
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(Stream, CpioFormat)
Speichern Sie Archive in den Stream mit gzip-Kompression.
public void SaveGzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das 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
Es muss geschrieben werden.
Exceptions
output’ is null.
output’ is not writable.
SaveGzipped(String, CpioFormat)
Speichert die Datei mit gzip-Kompression.
public void SaveGzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
path string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das 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");
}
}Gefüllung komprimiert(Stream, CpioFormat)
Speichern Sie das Archiv in den Strom mit LZMA-Kompression.
public void SaveLZMACompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das 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
Es muss geschrieben werden.
Wichtig: Cpio-Archiv wird dann in dieser Methode komprimiert, seine Inhalte werden intern beibehalten.
Gefüllung komprimiert(String, CpioFormat)
Speichern Sie das Archiv in die Datei mit Lzma-Kompression.
public void SaveLZMACompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
path string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das 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
Wichtig: Cpio-Archiv wird dann in dieser Methode komprimiert, seine Inhalte werden intern beibehalten.
SaveLzipped(Stream, CpioFormat)
Speichern Sie Archive in den Strom mit Lzip-Kompression.
public void SaveLzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das 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
Es muss geschrieben werden.
Exceptions
output’ is null.
output’ is not writable.
SaveLzipped(String, CpioFormat)
Speichert die Datei mit Lzip-Kompression.
public void SaveLzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
path string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das 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)
Er spart den Archiv in den Strom mit xz-Kompression.
public void SaveXzCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das Cpio Header Format.
settings XzArchiveSettings
Set der Einrichtung bestimmter xz-Archive: Wörterbuchgröße, Blockgröße, Check-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
Der Stream muss schriftlich sein.
Exceptions
output’ is null.
output’ is not writable.
SaveXzCompressed(String, CpioFormat, XzArchiveSettings)
Speichert Archiv auf den Weg mit xz-Kompressionen.
public void SaveXzCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)Parameters
path string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das Cpio Header Format.
settings XzArchiveSettings
Set der Einrichtung bestimmter xz-Archive: Wörterbuchgröße, Blockgröße, Check-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");
}
}Gefüllung komprimiert(Stream, CpioFormat)
Er spart den Archiv in den Strom mit Z-Kompression.
public void SaveZCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das 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
Es muss geschrieben werden.
Exceptions
output’ is null.
output’ is not writable.
Gefüllung komprimiert(String, CpioFormat)
Er spart Archiv auf den Weg mit Z-Kompressionen.
public void SaveZCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
path string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das 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(Stream, CpioFormat)
Speichern Sie Archive in den Strom mit Standard-Kompression.
public void SaveZstandard(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
output Stream
Der Destinationstrom.
cpioFormat CpioFormat
Definiert das 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
Es muss geschrieben werden.
Exceptions
output’ is null.
output’ is not writable.
SaveZstandard(String, CpioFormat)
Speichert die Datei auf dem Weg mit Zstandard-Kompression.
public void SaveZstandard(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)Parameters
path string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
cpioFormat CpioFormat
Definiert das 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");
}
}