TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

Einzelner Eintrag im Archiv erstellen.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ParameterTypBeschreibung
nameStringDer Name des Eintrags.
sourceStreamDer Eingabestream für den Eintrag.
fileInfoFileSystemInfoDie Metadaten der zu komprimierenden Datei oder des Ordners.

Rückgabewert

Tar-Eintragsinstanz.

Ausnahmen

AusnahmeBedingung
PathTooLongExceptionname ist nach IEEE 1003.1-1998-Standard zu lang für tar.
ArgumentExceptionDateiname, als Teil vonname, überschreitet 100 Symbole.

Bemerkungen

Der Eintragsname wird ausschließlich innerhalb gesetztname Parameter. Der Dateiname, der in bereitgestellt wirdfileInfo Parameter wirkt sich nicht auf den Eintragsnamen aus.

fileInfo verweisen kannDirectoryInfo wenn der Eintrag Verzeichnis ist.

Beispiele

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

Siehe auch


CreateEntry(string, FileInfo, bool)

Einzelner Eintrag im Archiv erstellen.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParameterTypBeschreibung
nameStringDer Name des Eintrags.
fileInfoFileInfoDie Metadaten der zu komprimierenden Datei oder des Ordners.
openImmediatelyBooleanWahr, wenn die Datei sofort geöffnet wird, andernfalls die Datei beim Archivspeichern öffnen.

Rückgabewert

Tar-Eintragsinstanz.

Ausnahmen

AusnahmeBedingung
PathTooLongExceptionname ist nach IEEE 1003.1-1998-Standard zu lang für tar.
ArgumentExceptionDateiname, als Teil vonname, überschreitet 100 Symbole.

Bemerkungen

Der Eintragsname wird ausschließlich innerhalb gesetztname Parameter. Der Dateiname, der in bereitgestellt wirdfileInfo Parameter wirkt sich nicht auf den Eintragsnamen aus.

fileInfo verweisen kannDirectoryInfo wenn der Eintrag Verzeichnis ist.

Wird die Datei sofort mit geöffnetopenImmediatelyParameter wird es blockiert, bis das Archiv entsorgt wird.

Beispiele

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

Siehe auch


CreateEntry(string, string, bool)

Einzelner Eintrag im Archiv erstellen.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ParameterTypBeschreibung
nameStringDer Name des Eintrags.
pathStringPfad zur zu komprimierenden Datei.
openImmediatelyBooleanWahr, wenn die Datei sofort geöffnet wird, andernfalls die Datei beim Archivspeichern öffnen.

Rückgabewert

Tar-Eintragsinstanz.

Ausnahmen

AusnahmeBedingung
ArgumentNullExceptionpath ist Null.
SecurityExceptionDer Anrufer verfügt nicht über die erforderliche Zugriffsberechtigung.
ArgumentExceptionDerpath leer ist, nur Leerzeichen enthält oder ungültige Zeichen enthält. - oder - Dateiname, als Teil vonname, überschreitet 100 Symbole.
UnauthorizedAccessExceptionZugriff auf Dateipath ist abgelehnt.
PathTooLongExceptionDie angegebenepath , 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. - oder -name ist nach IEEE 1003.1-1998-Standard zu lang für tar.
NotSupportedExceptionDatei unterpath enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

Bemerkungen

Der Eintragsname wird ausschließlich innerhalb gesetztname Parameter. Der Dateiname, der in bereitgestellt wirdpath Parameter wirkt sich nicht auf den Eintragsnamen aus.

Wird die Datei sofort mit geöffnetopenImmediatelyParameter wird es blockiert, bis das Archiv entsorgt wird.

Beispiele

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

Siehe auch