Class XarArchive
Il nome: Aspose.Zip.Xar Assemblea: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta un file di archivio xar.
public class XarArchive : IArchive, 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
XarArchive(XarCompressionSettings)
Inizia una nuova instanza della classe Aspose.Zip.Xar.XarArchive.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parameters
defaultCompressionSettings XarCompressionSettings
Le impostazioni di compressione predefinite, applicate a tutte le entrate dell’archivio.
Examples
Il seguente esempio mostra come comprimere un file.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(Strumento, XarLoadOptions)
Inizia una nuova instanza della classe Aspose.Zip.Xar.xarArchive e compone un elenco di entrate che può essere estratto dall’archivio.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parameters
sourceStream Stream
La fonte dell’archivio. deve essere ricercabile.
loadOptions XarLoadOptions
Le opzioni per caricare archivio con.
Examples
L’esempio seguente mostra come estrarre tutte le entrate in un directory.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Questo costruttore non spazzatura nessun ingresso. vedi Aspose.Zip.Xar.XarFileEntry.Open metodo per spazzatura.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid xar archive.
XarArchive(String, XarLoadOptions)
Inizia una nuova instanza della classe Aspose.Zip.Xar.xarArchive e compone un elenco di entrate che può essere estratto dall’archivio.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parameters
path string
Il percorso verso l’archivio.
loadOptions XarLoadOptions
Le opzioni per caricare archivio con.
Examples
L’esempio seguente mostra come estrarre tutte le entrate in un directory.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Questo costruttore non spazzatura nessun ingresso. vedi Aspose.Zip.Xar.XarFileEntry.Open metodo per spazzatura.
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.
Il file in path’ non è un archivio xar valido.
Properties
Entries
Riceve le entrate di Aspose.Zip.Xar.XarEntry tipo che costituisce l’archivio.
public IEnumerable<xarentry> Entries { get; }Valore di proprietà
IEnumerable di < XarEntry >
Methods
CreateEntries(string, bool, XarCompressionSettings)
Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
sourceDirectory string
Direttore per la compressione.
includeRootDirectory bool
Indica se includere lo stesso directory root o meno.
compressionSettings XarCompressionSettings
Le impostazioni di compressione utilizzate per aggiungere elementi Aspose.Zip.Xar.XarEntry.
Returns
L’istanza di ingresso.
Examples
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(@"C:\folder", false);
archive.Save(xarFile);
}
}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(DirettoreInfo, bool, XarCompressionSettings)
Aggiungi all’archivio tutti i file e i directory recursivamente nel directory dato.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
directory DirectoryInfo
Direttore per la compressione.
includeRootDirectory bool
Indica se includere lo stesso directory root o meno.
compressionSettings XarCompressionSettings
Le impostazioni di compressione utilizzate per aggiungere elementi Aspose.Zip.Xar.XarEntry.
Returns
L’istanza di ingresso.
Examples
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
archive.Save(xarFile);
}
}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(stringa, FileInfo, bool, XarCompressionSettings)
Creare un singolo ingresso all’interno dell’archivio.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)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.
compressionSettings XarCompressionSettings
Le impostazioni di compressione utilizzate per aggiungere Aspose.Zip.Xar.XarEntry elemento.
Returns
L’istanza di ingresso.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}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, bool, XarCompressionSettings)
Creare un singolo ingresso all’interno dell’archivio.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)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.
compressionSettings XarCompressionSettings
Le impostazioni di compressione utilizzate per aggiungere Aspose.Zip.Xar.XarEntry elemento.
Returns
L’istanza di ingresso.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}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. - o - name’ è troppo lungo per xar.
Il file in sourcePath’ contiene una colonna (:) nel mezzo della riga.
Impossibile modificare l’archivio.
CreateEntry(Strumento, Strumento, XarCompressionSettings)
Creare un singolo ingresso all’interno dell’archivio.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parameters
name string
Il nome dell’ingresso.
source Stream
Il flusso di ingresso per l’ingresso.
compressionSettings XarCompressionSettings
Le impostazioni di compressione utilizzate per aggiungere Aspose.Zip.Xar.XarEntry elemento.
Returns
L’istanza di ingresso.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.xar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
Impossibile modificare l’archivio.
DeleteEntry(XarEntry)
Rimuove la prima comparsa di un’entrata specifica dall’elenco delle entrate.
public XarArchive DeleteEntry(XarEntry entry)Parameters
entry XarEntry
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 XarArchive("archive.xar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}Exceptions
entry’ is null.
Dispose()
Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.
public void Dispose()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.
ExtractToDirectory(String)
Estratta tutti i file nell’archivio nel directory fornito.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Il percorso verso il directory per posizionare i file estratti.
Examples
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Se il directory non esiste, sarà creato.
Exceptions
Il percorso è zero
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.
Il chiamante non ha il permesso richiesto per accedere al directory esistente.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“C:”).
Il percorso è una riga di lunghezza zero, contiene solo spazio bianco, o contiene uno o più caratteri invalidi. Puoi chiedere caratteri invalidi utilizzando il metodo System.IO.Path.GetInvalidPathChars. -o- percorso è prefinito con, o contiene, solo un carattere colonico (:).
Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.
L’archivio è corrotto.
Save(String, XarSaveOptions)
Salva l’archivio al file di destinazione fornito.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parameters
destinationFileName string
Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.
saveOptions XarSaveOptions
Opzioni per salvare archivio xar con.
Exceptions
destinationFileName’ is null.
Impossibile modificare l’archivio.
Save(Strumento, XarSaveOptions)
Salva archivio al flusso fornito.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parameters
output Stream
Il flusso di destinazione.
saveOptions XarSaveOptions
Opzioni per salvare archivio xar con.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
Impossibile modificare l’archivio.
