Class XarArchive
De naam: Aspose.Zip.Xar Verzameling: Aspose.Zip.dll (25.5.0)
Deze klasse is een xar archiefbestand.
public class XarArchive : IArchive, IDisposableInheritance
Implements
Geëerbiede leden
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XarArchive(XarCompressionSettings)
Initialiseert een nieuwe instantie van de Aspose.Zip.Xar.XarArchive klasse.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parameters
defaultCompressionSettings XarCompressionSettings
De standaard compressie-instellingen, die van toepassing zijn op alle inzichten in het archief.
Examples
Het volgende voorbeeld laat zien hoe u een bestand kunt compresseren.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(Stream, XarLoadOptions)
Initialiseert een nieuwe instantie van de Aspose.Zip.Xar.xarArchive-klasse en maakt een inganglijst die kan worden geïntroduceerd uit het archief.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parameters
sourceStream Stream
De bron van het archief. het moet zoeken.
loadOptions XarLoadOptions
De opties om archief te laden met.
Examples
Het volgende voorbeeld laat zien hoe u alle inzichten in een directory kunt extraheren.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Deze constructor verwijdert geen ingang. zie Aspose.Zip.Xar.XarFileEntry.Open methode voor verwijdering.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid xar archive.
XarArchive(String, XarLoadOptions)
Initialiseert een nieuwe instantie van de Aspose.Zip.Xar.xarArchive-klasse en maakt een inganglijst die kan worden geïntroduceerd uit het archief.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parameters
path string
De weg naar het archiefbestand.
loadOptions XarLoadOptions
De opties om archief te laden met.
Examples
Het volgende voorbeeld laat zien hoe u alle inzichten in een directory kunt extraheren.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Deze constructor verwijdert geen ingang. zie Aspose.Zip.Xar.XarFileEntry.Open methode voor verwijdering.
Exceptions
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.
Het bestand op path’ bevat een kolom (:) in het midden van de string.
Het bestand is niet gevonden.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
Het bestand bij path’ is niet geldig voor het xar archief.
Properties
Entries
Geeft input van Aspose.Zip.Xar.XarEntry type die het archief vormt.
public IEnumerable<xarentry> Entries { get; }Eigendomswaarde
IEnumerable < XarEntry >
Methods
CreateEntries(string, bool, XarCompressionSettings)
Toegevoegd aan het archief alle bestanden en directories herhaaldelijk in de gegeven directory.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
sourceDirectory string
Directory voor compressie.
includeRootDirectory bool
Hiermee wordt aangegeven of de root directory zelf moet worden opgenomen of niet.
compressionSettings XarCompressionSettings
De compressie-instellingen die worden gebruikt voor het toevoegen van Aspose.Zip.Xar.XarEntry items.
Returns
Xar ingang instantie.
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.
De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
De aangegeven pad, bestandnaam, of beide overschrijden de systeemdefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, paden moeten minder dan 248 tekens, en bestandnamen moeten minder dan 260 tekens.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DirectoryInfo, bool, XarCompressionSettings)
Toegevoegd aan het archief alle bestanden en directories herhaaldelijk in de gegeven directory.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
directory DirectoryInfo
Directory voor compressie.
includeRootDirectory bool
Hiermee wordt aangegeven of de root directory zelf moet worden opgenomen of niet.
compressionSettings XarCompressionSettings
De compressie-instellingen die worden gebruikt voor het toevoegen van Aspose.Zip.Xar.XarEntry items.
Returns
Xar ingang instantie.
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.
De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot directory'.
directory’ stands for a file, not for a directory.
CreateEntry(string, FileInfo, bool, XarCompressionSettings)
Creëren van een enkele ingang binnen het archief.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
De naam van de ingang.
fileInfo FileInfo
De metadata van het bestand of de map om te worden gecomprimeerd.
openImmediately bool
Het is waar, als u het bestand onmiddellijk opent, anders opent u het bestand op archiefopslag.
compressionSettings XarCompressionSettings
De compressie-instellingen die worden gebruikt voor het toevoegen van Aspose.Zip.Xar.XarEntry item.
Returns
Xar ingang instantie.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}Remarks
Als het bestand onmiddellijk wordt geopend met de parameter wordt het geblokkeerd totdat het archief is verwijderd.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(string, string, bool, XarCompressionSettings)
Creëren van een enkele ingang binnen het archief.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
De naam van de ingang.
sourcePath string
De weg naar het bestanden om gecomprimeerd te worden.
openImmediately bool
Het is waar, als u het bestand onmiddellijk opent, anders opent u het bestand op archiefopslag.
compressionSettings XarCompressionSettings
De compressie-instellingen die worden gebruikt voor het toevoegen van Aspose.Zip.Xar.XarEntry item.
Returns
Xar ingang instantie.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}Remarks
De invoernaam is uitsluitend ingesteld binnen de parameter.De in de parameter verstrekte bestandnaam beïnvloedt de invoernaam niet.
Als het bestand onmiddellijk wordt geopend met de parameter wordt het geblokkeerd totdat het archief is verwijderd.
Exceptions
sourcePath’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De sourcePath’ is leeg, bevat alleen witte ruimtes, of bevat ongeldig tekens. - of - File name, als onderdeel van name’, overschrijdt 100 symbolen.
De toegang tot het bestand sourcePath’ wordt geweigerd.
De aangegeven sourcePath’, bestandnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens zijn en bestandnamen moeten minder dan 260 tekens zijn. - of - name’ is te lang voor xar.
Het bestand bij sourcePath’ bevat een kolom (:) in het midden van de string.
Het is onmogelijk om het xar archief te wijzigen.
CreateEntry(String, Stream, XarCompressionSettings)
Creëren van een enkele ingang binnen het archief.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parameters
name string
De naam van de ingang.
source Stream
De ingangstromen voor de ingang.
compressionSettings XarCompressionSettings
De compressie-instellingen die worden gebruikt voor het toevoegen van Aspose.Zip.Xar.XarEntry item.
Returns
Xar ingang instantie.
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.
Het is onmogelijk om het xar archief te wijzigen.
DeleteEntry(XarEntry)
Verwijder de eerste verschijning van een specifieke ingang uit de inganglijst.
public XarArchive DeleteEntry(XarEntry entry)Parameters
entry XarEntry
De ingang om te verwijderen uit de inganglijst.
Returns
Xar ingang instantie.
Examples
Hier is hoe u alle inschrijvingen kunt verwijderen met uitzondering van de laatste:
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()
Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.
public void Dispose()Dispose(Bool)
Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Of de beheerde middelen moeten worden afgebroken.
ExtractToDirectory(String)
Extract alle bestanden in het archief naar het verstrekte directory.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
De route naar het directory om de geïntroduceerde bestanden in te plaatsen.
Examples
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Als de directory niet bestaat, wordt deze gemaakt.
Exceptions
De weg is nul
De aangegeven pad, bestandnaam of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens en bestandnamen moeten minder dan 260 tekens zijn.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen tot de bestaande directory.
Als de directory niet bestaat, bevat de route een colon karakter (:) dat niet deel uitmaakt van een drive label (“C:”).
Path is een nullengte string, bevat alleen witte ruimte, of bevat één of meer invalide karakters. u kunt vragen voor invalide karakters door gebruik te maken van de System.IO.Path.GetInvalidPathChars methode. -of- pad is vooraf vastgesteld met, of bevat, slechts een colon karakter (:).
De door de route aangegeven directory is een bestand. -or- De netwerknaam is niet bekend.
Het archief is corrupt.
Save(String, XarSaveOptions)
Het archief wordt opgeslagen naar het bestand van bestemming.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parameters
destinationFileName string
De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.
saveOptions XarSaveOptions
Opties om xar archief te bewaren met.
Exceptions
destinationFileName’ is null.
Het is onmogelijk om het xar archief te wijzigen.
Save(Stream, XarSaveOptions)
Speel archief op de geleverde stroom.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parameters
output Stream
De bestemming stroom.
saveOptions XarSaveOptions
Opties om xar archief te bewaren met.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
Het is onmogelijk om het xar archief te wijzigen.
