TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

Skapa en enskild post i arkivet.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ParameterTypBeskrivning
nameStringNamnet på posten.
sourceStreamIngångsströmmen för posten.
fileInfoFileSystemInfoMetadata för fil eller mapp som ska komprimeras.

Returvärde

Tar inträdesinstans.

Undantag

undantagskick
PathTooLongExceptionname är för lång för tjära enligt IEEE 1003.1-1998 standard.
ArgumentExceptionFilnamn, som en del avname, överstiger 100 symboler.

Anmärkningar

Postens namn anges endast inomname parameter. Filnamnet som anges ifileInfo parametern påverkar inte postens namn.

fileInfo kan hänvisa tillDirectoryInfo om posten är katalog.

Exempel

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Se även


CreateEntry(string, FileInfo, bool)

Skapa en enskild post i arkivet.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParameterTypBeskrivning
nameStringNamnet på posten.
fileInfoFileInfoMetadata för fil eller mapp som ska komprimeras.
openImmediatelyBooleanSant om du öppnar filen omedelbart, annars öppnar du filen när du sparar arkivet.

Returvärde

Tar inträdesinstans.

Undantag

undantagskick
PathTooLongExceptionname är för lång för tjära enligt IEEE 1003.1-1998 standard.
ArgumentExceptionFilnamn, som en del avname, överstiger 100 symboler.

Anmärkningar

Postens namn anges endast inomname parameter. Filnamnet som anges ifileInfo parametern påverkar inte postens namn.

fileInfo kan hänvisa tillDirectoryInfo om posten är katalog.

Om filen öppnas omedelbart medopenImmediatelyparametern blockeras den tills arkivet kasseras.

Exempel

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Se även


CreateEntry(string, string, bool)

Skapa en enskild post i arkivet.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ParameterTypBeskrivning
nameStringNamnet på posten.
pathStringSökväg till fil som ska komprimeras.
openImmediatelyBooleanSant om du öppnar filen omedelbart, annars öppnar du filen när du sparar arkivet.

Returvärde

Tar inträdesinstans.

Undantag

undantagskick
ArgumentNullExceptionpath är inget.
SecurityExceptionDen som ringer har inte den behörighet som krävs för att få åtkomst.
ArgumentExceptionDepath är tom, innehåller bara blanksteg eller innehåller ogiltiga tecken. - eller - Filnamn, som en del avname, överstiger 100 symboler.
UnauthorizedAccessExceptionTillgång till filpath är nekad.
PathTooLongExceptionDen angivnapath , filnamn eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar måste sökvägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken. - eller -name är för lång för tjära enligt IEEE 1003.1-1998 standard.
NotSupportedExceptionArkivera klpath innehåller ett kolon (:) i mitten av strängen.

Anmärkningar

Postens namn anges endast inomname parameter. Filnamnet som anges ipath parametern påverkar inte postens namn.

Om filen öppnas omedelbart medopenImmediatelyparametern blockeras den tills arkivet kasseras.

Exempel

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

Se även