Class XarFileEntry

Class XarFileEntry

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

Stellt einen Dateieintrag innerhalb des xar-Archivs dar.

public sealed class XarFileEntry : XarEntry, IArchiveFileEntry

Vererbung

object ← XarEntry ← XarFileEntry

Implementiert

IArchiveFileEntry

Vererbte Mitglieder

XarEntry.ToString(), XarEntry.Name, XarEntry.FullPath, XarEntry.IsDirectory, XarEntry.Parent, XarEntry.CreationTime, XarEntry.LastAccessTime, XarEntry.LastWriteTime, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Eigenschaften

Länge

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

public long Length { get; }

Eigenschaftswert

long

Methoden

Extract(string)

Extrahiert den Eintrag in das Dateisystem anhand des angegebenen Pfades.

public FileInfo Extract(string path)

Parameter

path string

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

Rückgabewert

FileInfo

Die Dateiinformationen der zusammengesetzten Datei.

Beispiele 

using (var archive = new XarArchive("archive.xar"))
{
    ((XarFileEntry)archive.Entries[0]).Extract("data.bin");
}

Ausnahmen

ArgumentNullException

path ist null.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

ArgumentException

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

UnauthorizedAccessException

Zugriff auf die Datei path ist verweigert.

PathTooLongException

Der angegebene path, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.

NotSupportedException

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

InvalidDataException

Archiv ist beschädigt.

Extract(Stream)

Extrahiert den Eintrag in den bereitgestellten Stream.

public void Extract(Stream destination)

Parameter

destination Stream

Zielstream. Muss beschreibbar sein.

Beispiele

Extrahieren Sie einen Eintrag aus dem xar-Archiv.

using (var archive = new XarArchive("archive.xar"))
{
    ((XarFileEntry)archive.Entries[0]).Extract(httpResponseStream);
}

Ausnahmen

ArgumentException

destination unterstützt das Schreiben nicht.

InvalidDataException

Archiv ist beschädigt.

Open()

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

public Stream Open()

Rückgabewert

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 vom Stream, um den ursprünglichen Inhalt der Datei zu erhalten. Siehe Abschnitt Beispiele.

### <a id="Aspose_Zip_Xar_XarFileEntry_CompressionProgressed"></a> CompressionProgressed

Wird ausgelöst, wenn ein Teil des Rohstreams komprimiert wird.

```csharp
public event EventHandler<progresseventargs> CompressionProgressed

Ereignistyp

EventHandler<ProgressEventArgs&gt;

Beispiele

archive.Entries.First().CompressionProgressed += (s, e) =&gt; { int percent = (int)((100 * (long)e.ProceededBytes) / entrySourceStream.Length); };

Bemerkungen

Der Ereignisauslöser ist eine Instanz von Aspose.Zip.Xar.XarFileEntry.

 Deutsch