Class ArchiveEntry

Class ArchiveEntry

Nom dels espais: Aspose.Zip Assemblea: Aspose.Zip.dll (25.5.0)

Representa un únic arxiu dins de l’arxiu.

public abstract class ArchiveEntry : IArchiveFileEntry

Inheritance

object ArchiveEntry

Derived

ArchiveEntryEncrypted , ArchiveEntryPlain

Implements

IArchiveFileEntry

Membres heretats

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

Remarks

Escriu una instància Aspose.Zip.ArchiveEntry a Aspose.Zip.ArchiveEntryEncripta per determinar si la entrada està encryptada o no.

Constructors

ArchiveEntry(CompressióSettings, Funci UINT)

Inicia una nova instància de la classe Aspose.Zip.ArchiveEntry.

protected ArchiveEntry(string name, CompressionSettings compressionSettings, Func<stream> sourceProvider, uint fileAttributes)

Parameters

name string

El nom d’entrada.

compressionSettings CompressionSettings

Configuració de compressió o decompressi.

sourceProvider Func < Stream >

El mètode de retorn del flux amb les dades d’entrada s’ha de comprimir.

fileAttributes uint

Atributs del sistema de fitxers.

ArchiveEntry(string, CompressióSettings, Stream, uint, FileSystemInfo)

Inicia una nova instància de la classe Aspose.Zip.ArchiveEntry.

protected ArchiveEntry(string name, CompressionSettings compressionSettings, Stream source, uint fileAttributes, FileSystemInfo fileInfo = null)

Parameters

name string

El nom d’entrada.

compressionSettings CompressionSettings

Configuració de compressió o decompressi.

source Stream

El flux amb les dades d’entrada o per ser comprès o per ser descompressat.

fileAttributes uint

Atributs del sistema de fitxers.

fileInfo FileSystemInfo

Arxiu o directori d’informació de la entrada basada en.

Properties

Comment

Obté un comentari de l’entrada dins de l’arxiu.

public string Comment { get; protected set; }

Valor de la propietat

string

CompressedSize

Obté la mida del fitxer comprès.

public ulong CompressedSize { get; }

Valor de la propietat

ulong

CompressionSettings

Obté ajustos per a la compressió o la decompressi.

public CompressionSettings CompressionSettings { get; }

Valor de la propietat

CompressionSettings

DataSource

Font de l’entrada si la entrada va ser afegida a l’arxiu, no extraïda.

public Stream DataSource { get; }

Valor de la propietat

Stream

Remarks

Abans d’assignar, la font és nul. Aquesta font pot ser assignada dins del mètode ‘Archive.Save’ en alguns casos.

FileAttributes

Obté atributs de fitxers del sistema host.

protected FileAttributes FileAttributes { get; }

Valor de la propietat

FileAttributes

IsDirectory

Obté un valor que indiqui si la entrada representa un directori.

public bool IsDirectory { get; }

Valor de la propietat

bool

ModificationTime

Obtenir o establir la data i l’hora modificades més tard.

public DateTime ModificationTime { get; set; }

Valor de la propietat

DateTime

Name

Obté el nom de l’entrada dins de l’arxiu.

public string Name { get; protected set; }

Valor de la propietat

string

UncompressedSize

Obté la mida del fitxer original.

public ulong UncompressedSize { get; }

Valor de la propietat

ulong

Methods

Extract(Tècnic, Tècnic)

Extreu l’entrada al sistema de fitxers pel camí proporcionat.

public FileInfo Extract(string path, string password = null)

Parameters

path string

El camí a l’arxiu de destinació. Si el fitxer ja existeix, serà sobreescrit.

password string

Password opcional per a la decrypci.

Returns

FileInfo

Informació del fitxer del fitxer compost.

Examples

Extraure dues entrades de l’arxiu zip, cadascuna amb la seva pròpia contrasenya

using (FileStream zipFile = File.Open("archive.zip", FileMode.Open))
{
    using (Archive archive = new Archive(zipFile))
    {
        archive.Entries[0].Extract("first.bin", "first_pass");
        archive.Entries[1].Extract("second.bin", "second_pass");
    }
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

FileNotFoundException

El fitxer no es troba.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

El fitxer ja està obert.

InvalidDataException

Les dades estan corrompudes. -o- la verificació CRC o MAC ha fracassat per a la entrada.

Extract(Tàrrega, Tàrrega)

Extrata l’entrada al flux proporcionat.

public void Extract(Stream destination, string password = null)

Parameters

destination Stream

La destinació ha de ser escrita.

password string

Password opcional per a la decrypci.

Examples

Extraure una entrada d’arxiu zip amb una contrasenya.

using (FileStream zipFile = File.Open("archive.zip", FileMode.Open))
{
    using (Archive archive = new Archive(zipFile))
    {
        archive.Entries[0].Extract(httpResponseStream, "p@s$");
    }
}

Exceptions

InvalidDataException

Les dades estan corrompudes. -o- la verificació CRC o MAC ha fracassat per a la entrada.

IOException

La font és corrupta o no llegible.

ArgumentException

destination’ does not support writing.

Open(Tàrrega)

Obre l’entrada per a l’extracció i proporciona un flux amb contingut d’entrada descompressat.

public Stream Open(string password = null)

Parameters

password string

Password opcional per a la decrypci.

Returns

Stream

El corrent que representa el contingut de la entrada.

Examples

Utilitzaci:Stream decompressed = entry.Open();

.NET 4.0 i superior - utilitzar el mètode Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 i abans - copiar els bytes manualment:

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

#### Remarks

<p>Read from the stream to get the original content of a file. See examples section.</p>

#### Exceptions

 [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)

The archive is in an incorrect state.

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

Raises when a portion of raw stream compressed.

```csharp
public event EventHandler<progresseventargs> CompressionProgressed

Tipus d’esdeveniment

EventHandler < ProgressEventArgs >

Examples

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

Remarks

El missatger d’esdeveniments és una instància Aspose.Zip.ArchiveEntry.

ExtractionProgressed

Augmenta quan s’extreu una porció de flux brut.

public event EventHandler<progresseventargs> ExtractionProgressed

Tipus d’esdeveniment

EventHandler < ProgressEventArgs >

Examples

archive.Entries[0].ExtractionProgressed += (s, e) =&gt; { int percent = (int)((100 * e.ProceededBytes) / ((ArchiveEntry)s).UncompressedSize); };

Remarks

El missatger d’esdeveniments és una instància Aspose.Zip.ArchiveEntry.

 Català