Class TarEntry

Class TarEntry

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Stellt eine einzelne Datei innerhalb eines Tar-Archivs dar.

public class TarEntry : IArchiveFileEntry

Vererbung

objectTarEntry

Implementiert

IArchiveFileEntry

Vererbte Mitglieder

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Eigenschaften

IsDirectory

Erhält einen Wert, der angibt, ob der Eintrag ein Verzeichnis darstellt.

public bool IsDirectory { get; }

Eigenschaftswert

bool

Length

Erhält die Länge des Eintrags in Bytes.

public long Length { get; }

Eigenschaftswert

long

Name

Erhält oder setzt den Namen des Eintrags innerhalb des Archivs.

public string Name { get; set; }

Eigenschaftswert

string

Methoden

Extract(string)

Extrahiert den Eintrag in das Dateisystem anhand des angegebenen Pfads.

public FileSystemInfo Extract(string path)

Parameter

path string

Der Pfad zur Zieldatei. Wenn die Datei bereits existiert, wird sie überschrieben.

Rückgabe

FileSystemInfo

Die Datei-Info der zusammengesetzten Datei.

Beispiele

using (var archive = new TarArchive("archive.tar"))
{
    archive.Entries[0].Extract("data.bin");
}

Ausnahmen

ArgumentNullException

path ist null.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung für den Zugriff.

ArgumentException

Der path ist leer, enthält nur Leerzeichen oder ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path ist verweigert.

PathTooLongException

Der angegebene path, Dateiname oder beides überschreitet die vom System definiierte maximale Länge. Beispielsweise müssen unter Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

NotSupportedException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

Die Datei ist bereits geöffnet.

Extract(Stream)

Extrahiert den Eintrag in den angegebenen Stream.

public void Extract(Stream destination)

Parameter

destination Stream

Zielstream. Muss beschreibbar sein.

Beispiele

Extrahieren Sie einen Eintrag aus dem Tar-Archiv.

using (var archive = new TarArchive("archive.tar"))
{
    archive.Entries[0].Extract(httpResponseStream);
}

Ausnahmen

ArgumentException

destination unterstützt das Schreiben nicht.

Open()

Öffnet den Eintrag zur Extraktion und stellt einen Stream mit dem Inhalt des Eintrags bereit.

public Stream Open()

Rückgabe

Stream

Der Stream, der den Inhalt des Eintrags darstellt.

Beispiele

Verwendung: Stream decompressed = entry.Open();

.NET 4.0 und höher - verwenden Sie die Methode Stream.CopyTo: decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 und früher - kopieren Sie die Bytes manuell:

byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
 fileStream.Write(buffer, 0, bytesRead);
```</p>

#### Bemerkungen

Lesen Sie aus dem Stream, um den ursprünglichen Inhalt der Datei zu erhalten. Siehe Abschnitt Beispiele.
 Deutsch