TarArchive.Save

Save(Stream, TarFormat?)

Slaat archief op in de geleverde stream.

public void Save(Stream output, TarFormat? format = default)
ParameterTypeBeschrijving
outputStreamBestemmingsstroom.
formatNullable`1Definieert het formaat van de tar-koptekst. Null-waarde wordt indien mogelijk behandeld als UStar.

Uitzonderingen

uitzonderingvoorwaarde
ArgumentExceptionoutput is niet beschrijfbaar. - of -output is dezelfde stream waaruit we extraheren. - OF - Het is onmogelijk om het archief op te slaan informat vanwege formaatbeperkingen.

Opmerkingen

outputmoet beschrijfbaar zijn.

Voorbeelden

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

Zie ook


Save(string, TarFormat?)

Slaat archief op in opgegeven bestemmingsbestand.

public void Save(string destinationFileName, TarFormat? format = default)
ParameterTypeBeschrijving
destinationFileNameStringHet pad van het aan te maken archief. Als de opgegeven bestandsnaam naar een bestaand bestand verwijst, wordt dit overschreven.
formatNullable`1Definieert het formaat van de tar-koptekst. Null-waarde wordt indien mogelijk behandeld als UStar.

Uitzonderingen

uitzonderingvoorwaarde
ArgumentExceptiondestinationFileName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens zoals gedefinieerd door System.IO.Path.InvalidPathChars.
ArgumentNullExceptiondestinationFileName is niets.
PathTooLongExceptionDe opgegevendestinationFileName, bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximale lengte. Op Windows-gebaseerde platforms moeten paden bijvoorbeeld uit minder dan 248 tekens bestaan en moeten bestandsnamen uit minder dan 260 tekens bestaan.
DirectoryNotFoundExceptionDe opgegevendestinationFileName ongeldig is (het staat bijvoorbeeld op een niet-toegewezen schijf).
IOExceptionEr is een I/O-fout opgetreden bij het openen van het bestand.
UnauthorizedAccessExceptiondestinationFileName heeft een bestand opgegeven dat alleen-lezen is en de toegang is niet Read.-of- path heeft een map opgegeven.-of- De beller heeft niet de vereiste machtigingen.
NotSupportedExceptiondestinationFileName heeft een ongeldig formaat.

Opmerkingen

Het is mogelijk om een archief op te slaan in hetzelfde pad als waaruit het is geladen. Dit wordt echter niet aanbevolen, omdat deze aanpak gebruikmaakt van kopiëren naar een tijdelijk bestand.

Voorbeelden

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

Zie ook