Class SharArchive
Nom dels espais: Aspose.Zip.Shar Assemblea: Aspose.Zip.dll (25.5.0)
Aquesta classe representa un arxiu encertat.
public class SharArchive : IDisposableInheritance
Implements
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Inicia una nova instància de la classe Aspose.Zip.Shar.SharArchive.
public SharArchive()Examples
L’exemple següent mostra com comprimir un fitxer.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(Tàrrega)
Inicia una nova instància de la classe Aspose.Zip.Shar.SharArchive preparada per a la decompressi.
public SharArchive(string path)Parameters
path string
El camí cap a la font de l’arxiu.
Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
Properties
Entries
Obté entrades del tipus Aspose.Zip.Shar.SharEntry que constitueix l’arxiu.
public ReadOnlyCollection<sharentry> Entries { get; }Valor de la propietat
ReadOnlyCollection < SharEntry >
Methods
CreateEntries(Tàrrega, Bool)
Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Direcció per a la compressi.
includeRootDirectory bool
Indica si incloure o no la pròpia direcció de les arrels.
Returns
Instància d’entrada de Shar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(sharFile);
}
}Exceptions
sourceDirectory’ is null.
El convocador no té el permís requerit per accedir a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DireccióInfo, Bool)
Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Direcció per a la compressi.
includeRootDirectory bool
Indica si incloure o no la pròpia direcció de les arrels.
Returns
Instància d’entrada de Shar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(sharFile);
}
}Exceptions
directory’ is null.
El convocador no té el permís requerit per accedir a la direcció directory'.
directory’ stands for a file, not for a directory.
CreateEntry(Arxiu, FileInfo, Bool)
Crear una entrada única dins de l’arxiu.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
El nom de l’entrada.
fileInfo FileInfo
Els metadats del fitxer o de la carpeta per a ser comprès.
openImmediately bool
s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.
Returns
Instància d’entrada de Shar.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(Tècnic, Tècnic, Tècnic)
Crear una entrada única dins de l’arxiu.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
El nom de l’entrada.
sourcePath string
El camí per a arxiu per a ser comprès.
openImmediately bool
s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.
Returns
Instància d’entrada de Shar.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
El nom d’entrada s’estableix únicament dins del paràmetre.El nom de fitxer proporcionat en el paràmetre no afecta el nom d’entrada.
Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.
Exceptions
sourcePath’ is null.
El client no té el permís d’accés requerit.
El sourcePath’ és buit, només conté espais blancs, o conté caràcters invalidats. - o - Nom de fitxer, com a part del name’, supera els 100 símbols.
L’accés al fitxer sourcePath’ es nega.
El nom de fitxer especificat sourcePath, o ambdós 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. - o - name’ és massa llarg per a escur.
El fitxer a sourcePath’ conté una columna (:) al mig de la cadena.
CreateEntry(Tàrrega, Tàrrega)
Crear una entrada única dins de l’arxiu.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
El nom de l’entrada.
source Stream
El flux d’entrada per a l’entrada.
Returns
Instància d’entrada de Shar.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.shar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
DeleteEntry(SharEntry)
Elimina la primera aparició d’una entrada específica de la llista d’entrada.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
L’entrada per eliminar de la llista d’entrada.
Returns
Instància d’entrada de Shar.
Examples
A continuació podeu eliminar totes les entrades excepte les últimes:
using (var archive = new SharArchive("archive.shar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputSharFile);
}Exceptions
entry’ is null.
DeleteEntry(Int)
Elimina l’entrada de la llista d’entrada per index.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
L’índex basat en zero de l’entrada a eliminar.
Returns
L’arxiu amb la entrada es va eliminar.
Examples
using (var archive = new SharArchive("two_files.shar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.shar");
}Exceptions
entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.
Dispose(La botiga)
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
S’han de disposar de recursos gestionats.
Dispose()
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
public void Dispose()Save(Tàrrega)
Salva l’arxiu a un arxiu de destinació proporcionat.
public void Save(string destinationFileName)Parameters
destinationFileName string
El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
s possible guardar un arxiu al mateix camí que es va carregar des. No obstant això, això no es recomana perquè aquest enfocament utilitza la còpia a un arxiu temporal.
Exceptions
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
La destinació especificada FileName’ és invalidada (per exemple, es troba en un disc no mapeat).
Un error I/O es va produir durant l’obertura del fitxer.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
El fitxer no es troba.
Save(Stream)
Salva l’arxiu al corrent proporcionat.
public void Save(Stream output)Parameters
output Stream
El flux de destinaci.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Ha de ser escriïble.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
