Class XarFileEntry

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

IArchiveFileEntry

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à

long

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

FileInfo

Le informazioni sul file composto.

Esempi 

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

Eccezioni

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

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.

NotSupportedException

Il file in path contiene due punti (:) nel mezzo della stringa.

InvalidDataException

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

ArgumentException

destination non supporta la scrittura.

InvalidDataException

L’archivio è corrotto.

Apri()

Apre l’entrata per l’estrazione e fornisce uno stream con il contenuto dell’entrata.

public Stream Open()

Restituisce

Stream

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&gt;

Esempi

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

Osservazioni

Il mittente dell’evento è un’istanza di Aspose.Zip.Xar.XarFileEntry.

 Italiano