TarArchive.Save

Save(Stream, TarFormat?)

Speichert das Archiv im bereitgestellten Stream.

public void Save(Stream output, TarFormat? format = default)
ParameterTypBeschreibung
outputStreamZielstrom.
formatNullable`1Definiert das tar-Header-Format. Nullwerte werden nach Möglichkeit als UStar behandelt.

Ausnahmen

AusnahmeBedingung
ArgumentExceptionoutput ist nicht beschreibbar. - oder -output ist der gleiche Stream, aus dem wir extrahieren. - ODER - Es ist unmöglich, das Archiv darin zu speichernformat aufgrund von Formatbeschränkungen.

Bemerkungen

outputmuss beschreibbar sein.

Beispiele

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(tarFile);
    }
}       

Siehe auch


Save(string, TarFormat?)

Speichert das Archiv in der bereitgestellten Zieldatei.

public void Save(string destinationFileName, TarFormat? format = default)
ParameterTypBeschreibung
destinationFileNameStringDer Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.
formatNullable`1Definiert das tar-Header-Format. Nullwerte werden nach Möglichkeit als UStar behandelt.

Ausnahmen

AusnahmeBedingung
ArgumentExceptiondestinationFileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen gemäß der Definition von System.IO.Path.InvalidPathChars.
ArgumentNullExceptiondestinationFileName ist Null.
PathTooLongExceptionDie angegebenedestinationFileName, Dateiname oder beide überschreiten die vom System definierte maximale Länge. Beispielsweise müssen auf Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen umfassen.
DirectoryNotFoundExceptionDie angegebenedestinationFileName ungültig ist (z. B. auf einem nicht zugeordneten Laufwerk).
IOExceptionBeim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
UnauthorizedAccessExceptiondestinationFileName eine Datei angegeben, die schreibgeschützt ist und der Zugriff nicht Read ist. – oder – Pfad ein Verzeichnis angegeben. – oder – Der Aufrufer hat nicht die erforderliche Berechtigung.
NotSupportedExceptiondestinationFileName hat ein ungültiges Format.

Bemerkungen

Es ist möglich, ein Archiv unter demselben Pfad zu speichern, aus dem es geladen wurde. Dies wird jedoch nicht empfohlen, da dieser Ansatz das Kopieren in eine temporäre Datei verwendet.

Beispiele

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}       

Siehe auch