Class XarFileEntry
Namespace: Aspose.Zip.Xar
Assembly: Aspose.Zip.dll (25.1.0)
Rappresenta un’entrata di file all’interno dell’archivio xar.
public sealed class XarFileEntry : XarEntry, IArchiveFileEntry
Ereditarietà
object ← XarEntry ← XarFileEntry
Implementa
Membri Ereditati
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()
Proprietà
Lunghezza
Ottiene la lunghezza dell’entrata in byte.
public long Length { get; }
Valore della Proprietà
Metodi
Estrai(string)
Estrae l’entrata nel filesystem tramite il percorso fornito.
public FileInfo Extract(string path)
Parametri
path
string
Il percorso del file di destinazione. Se il file esiste già, verrà sovrascritto.
Restituisce
Le informazioni sul file composto.
Esempi
using (var archive = new XarArchive("archive.xar"))
{
((XarFileEntry)archive.Entries[0]).Extract("data.bin");
}
Eccezioni
path
è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path
è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path
negato.
Il path
, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.
Il file in path
contiene due punti (:) nel mezzo della stringa.
L’archivio è corrotto.
Estrai(Stream)
Estrae l’entrata nello stream fornito.
public void Extract(Stream destination)
Parametri
destination
Stream
Stream di destinazione. Deve essere scrivibile.
Esempi
Estrai un'entrata dall'archivio xar.
using (var archive = new XarArchive("archive.xar"))
{
((XarFileEntry)archive.Entries[0]).Extract(httpResponseStream);
}
Eccezioni
destination
non supporta la scrittura.
L’archivio è corrotto.
Apri()
Apre l’entrata per l’estrazione e fornisce uno stream con il contenuto dell’entrata.
public Stream Open()
Restituisce
Lo stream che rappresenta i contenuti dell’entrata.
Esempi
Uso:
Stream decompressed = entry.Open();
.NET 4.0 e versioni successive - usa il metodo Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 e versioni precedenti - copia i byte manualmente:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Osservazioni
Leggi dallo stream per ottenere il contenuto originale del file. Vedi la sezione esempi.
### <a id="Aspose_Zip_Xar_XarFileEntry_CompressionProgressed"></a> CompressionProgressed
Si solleva quando una porzione di stream grezzo è compressa.
```csharp
public event EventHandler<progresseventargs> CompressionProgressed
Tipo di Evento
EventHandler<ProgressEventArgs>
Esempi
archive.Entries.First().CompressionProgressed += (s, e) => { int percent = (int)((100 * (long)e.ProceededBytes) / entrySourceStream.Length); };
Osservazioni
Il mittente dell’evento è un’istanza di Aspose.Zip.Xar.XarFileEntry.