Class SharArchive
Il nome: Aspose.Zip.Shar Assemblea: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta un file archivato acido.
public class SharArchive : IDisposableInheritance
Implements
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Inizia una nuova instanza della classe Aspose.Zip.Shar.SharArchive.
public SharArchive()Examples
Il seguente esempio mostra come comprimere un file.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(String)
Inizia una nuova instanza della classe Aspose.Zip.Shar.SharArchive preparata per la decompressione.
public SharArchive(string path)Parameters
path string
Il percorso verso la fonte dell’archivio.
Exceptions
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
Il file non è trovato.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file è già aperto.
Properties
Entries
Riceve le entrate di Aspose.Zip.Shar.SharEntry tipo che costituisce l’archivio.
public ReadOnlyCollection<sharentry> Entries { get; }Valore di proprietà
ReadOnlyCollection di < SharEntry >
Methods
CreateEntries(String e Bool)
Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Direttore per la compressione.
includeRootDirectory bool
Indica se includere lo stesso directory root o meno.
Returns
L’istanza di ingresso.
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.
Il chiamante non ha il permesso richiesto per accedere a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Sito ufficiale, bool)
Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Direttore per la compressione.
includeRootDirectory bool
Indica se includere lo stesso directory root o meno.
Returns
L’istanza di ingresso.
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.
Il chiamante non ha il permesso richiesto per accedere alla directory”.
directory’ stands for a file, not for a directory.
CreateEntry(String, FileInfo e Bool)
Creare un singolo ingresso all’interno dell’archivio.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Il nome dell’ingresso.
fileInfo FileInfo
I metadati del file o della cartella da comprimere.
openImmediately bool
È vero, se si apre immediatamente il file, altrimenti si apre il file su archivio di archiviazione.
Returns
L’istanza di ingresso.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Se il file viene aperto immediatamente con il parametro viene bloccato fino a quando l’archivio è disattivato.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String e Bool)
Creare un singolo ingresso all’interno dell’archivio.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Il nome dell’ingresso.
sourcePath string
Il modo in cui il file viene compreso.
openImmediately bool
È vero, se si apre immediatamente il file, altrimenti si apre il file su archivio di archiviazione.
Returns
L’istanza di ingresso.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
Il nome di ingresso è impostato esclusivamente all’interno del parametro.Il nome del file fornito nel parametro non influisce sul nome di ingresso.
Se il file viene aperto immediatamente con il parametro viene bloccato fino a quando l’archivio è disattivato.
Exceptions
sourcePath’ is null.
Il chiamante non ha il permesso di accesso richiesto.
Il sourcePath’ è vuoto, contiene solo spazi bianchi, o contiene caratteri invalidi. - o - Nome del file, come parte del name’, supera i 100 simboli.
L’accesso al file sourcePath’ è negato.
L’indicato sourcePath’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.
Il file in sourcePath’ contiene una colonna (:) nel mezzo della riga.
CreateEntry(Strumento, Stream)
Creare un singolo ingresso all’interno dell’archivio.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Il nome dell’ingresso.
source Stream
Il flusso di ingresso per l’ingresso.
Returns
L’istanza di ingresso.
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)
Rimuove la prima comparsa di un’entrata specifica dall’elenco delle entrate.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
L’ingresso da rimuovere dall’elenco delle entrate.
Returns
L’istanza di ingresso.
Examples
Ecco come puoi rimuovere tutte le entrate tranne l’ultima:
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)
Rimuovere l’ingresso dalla lista di ingressi per indice.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
L’indice basato su zero dell’ingresso da rimuovere.
Returns
L’archivio con l’ingresso è stato cancellato.
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(di bool)
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Le risorse gestite dovrebbero essere sprecate.
Dispose()
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
public void Dispose()Save(String)
Salva archivio a un file di destinazione fornito.
public void Save(string destinationFileName)Parameters
destinationFileName string
Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
È possibile salvare un archivio nello stesso percorso dal quale è stato caricato. tuttavia, questo non è raccomandato perché questo approccio utilizza la copia a un file temporaneo.
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.
La specifica destinationFileName’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.
La specifica destinationFileName’ è invalida (ad esempio, si trova su un disco non mappato).
Un errore I/O si è verificato durante l’apertura del file.
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.
Il file non è trovato.
Save(Stream)
Salva archivio al flusso fornito.
public void Save(Stream output)Parameters
output Stream
Il flusso di destinazione.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Deve essere scritta.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
