Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Σύνδεσμος, XarLoadOptions)`

Αρχίζει μια νέα παράσταση της κατηγορίας Aspose.Zip.xar.XarArchive και συνθέτει μια λίστα εισόδου που μπορεί να αφαιρεθεί από το αρχείο.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Ο δρόμος προς το αρχείο.

loadOptions XarLoadOptions

Οι επιλογές για να φορτώσετε τα αρχεία με.

`Examples`

Το παρακάτω παράδειγμα δείχνει πώς να εξαγάγετε όλες τις εγγραφές σε ένα δελτίο.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Αυτός ο κατασκευαστής δεν αφαίρεσε οποιαδήποτε είσοδο. Βλέπε Aspose.Zip.Xar.XarFileEntry.Open μέθοδος για την αφαίρεση.

`Exceptions`

path’ is null.

Ο κάτοχος δεν έχει την απαιτούμενη άδεια πρόσβασης.

UnauthorizedAccessException

Το path’ είναι άδειο, περιέχει μόνο λευκούς χώρους, ή περιέχει άκυρους χαρακτήρες.

Η πρόσβαση στο αρχείο path" αρνείται.

DirectoryNotFoundException

Το καθορισμένο path’, όνομα αρχείου, ή και τα δύο υπερβαίνουν το μέγιστο μήκος που καθορίζεται από το σύστημα. Για παράδειγμα, σε πλατφόρμες με βάση τα Windows, οι διαδρομές πρέπει να είναι λιγότερες από 248 χαρακτήρες και τα ονόματα αρχείων πρέπει να είναι λιγότερες από 260 χαρακτήρες.

NotSupportedException

Το αρχείο στο path’ περιέχει μια στήλη (:) στη μέση της γραμμής.

FileNotFoundException

Το αρχείο δεν βρέθηκε.

Η καθορισμένη διαδρομή είναι αναποτελεσματική, για παράδειγμα, να είναι σε μια μη χαρτογράφιμη οδήγηση.

Το αρχείο είναι ήδη ανοιχτό.

InvalidDataException

Το αρχείο στο path’ δεν είναι έγκυρο αρχείο xar.

`Properties`

`Entries`

Απολαμβάνει τις εγγραφές του τύπου Aspose.Zip.Xar.XarEntry που αποτελεί το αρχείο.

public IEnumerable<xarentry> Entries { get; }

`Αξία ιδιοκτησίας`

IEnumerable &lt · XarEntry >

`Methods`

`CreateEntries(Σύνδεσμος, Bool, XarCompressionSettings)`

Προσθέστε στο αρχείο όλα τα αρχεία και τις διευθύνσεις επανειλημμένα στο δεδομένο διευθύνσεις.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

Οδηγός για συμπίεση.

includeRootDirectory bool

Υποδεικνύει αν πρέπει να συμπεριληφθεί η ίδια η γραμμή ρίζας ή όχι.

compressionSettings XarCompressionSettings

Οι ρυθμίσεις συμπίεσης που χρησιμοποιούνται για την προσθήκη στοιχείων Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Εισαγωγική ένταξη.

`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.

Ο καλεστής δεν έχει την απαιτούμενη άδεια πρόσβασης στο sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

Για παράδειγμα, σε πλατφόρμες με βάση τα Windows, οι διαδρομές πρέπει να είναι λιγότερες από 248 χαρακτήρες και τα ονόματα αρχείων πρέπει να είναι λιγότερες από 260 χαρακτήρες.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(DirectoryInfo, Bool, XarCompressionSettings)`

Προσθέστε στο αρχείο όλα τα αρχεία και τις διευθύνσεις επανειλημμένα στο δεδομένο διευθύνσεις.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

Οδηγός για συμπίεση.

includeRootDirectory bool

Υποδεικνύει αν πρέπει να συμπεριληφθεί η ίδια η γραμμή ρίζας ή όχι.

compressionSettings XarCompressionSettings

Οι ρυθμίσεις συμπίεσης που χρησιμοποιούνται για την προσθήκη στοιχείων Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Εισαγωγική ένταξη.

`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.

Ο καλεστής δεν έχει την απαιτούμενη άδεια πρόσβασης στο directory”.

directory’ stands for a file, not for a directory.

`CreateEntry(Σύνδεσμος, FileInfo, Bool, XarCompressionSettings)`

Δημιουργήστε μια ενιαία είσοδο στο αρχείο.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Το όνομα της είσοδος.

fileInfo FileInfo

Τα μεταδεδομένα του αρχείου ή του φάκελου πρέπει να συμπιέζονται.

openImmediately bool

Αληθινά, αν ανοίξετε αμέσως το αρχείο, αλλιώς ανοίξτε το αρχείο στο αρχείο αποθήκευσης.

compressionSettings XarCompressionSettings

Οι ρυθμίσεις συμπίεσης που χρησιμοποιούνται για την προσθήκη στοιχείου Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Εισαγωγική ένταξη.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

`Remarks`

Εάν το αρχείο ανοίξει αμέσως με παράμετρο, μπλοκάρει μέχρι να διαγραφεί το αρχείο.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(Σύνδεση, Σύνδεση, Bool, XarCompressionSettings)`

Δημιουργήστε μια ενιαία είσοδο στο αρχείο.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Το όνομα της είσοδος.

sourcePath string

Ο τρόπος για να αρχίσετε να συμπιέσετε.

openImmediately bool

Αληθινά, αν ανοίξετε αμέσως το αρχείο, αλλιώς ανοίξτε το αρχείο στο αρχείο αποθήκευσης.

compressionSettings XarCompressionSettings

Οι ρυθμίσεις συμπίεσης που χρησιμοποιούνται για την προσθήκη στοιχείου Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Εισαγωγική ένταξη.

`Examples`

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

`Remarks`

Το όνομα εισόδου ρυθμίζεται μόνο μέσα σε παράμετρο.Το όνομα αρχείου που παρέχεται σε παράμετρο δεν επηρεάζει το όνομα εισόδου.

Εάν το αρχείο ανοίξει αμέσως με παράμετρο, μπλοκάρει μέχρι να διαγραφεί το αρχείο.

`Exceptions`

sourcePath’ is null.

Ο κάτοχος δεν έχει την απαιτούμενη άδεια πρόσβασης.

UnauthorizedAccessException

Το sourcePath’ είναι κενό, περιέχει μόνο λευκούς χώρους, ή περιέχει άκυρους χαρακτήρες. - ή - Το όνομα αρχείου, ως μέρος του name’, υπερβαίνει τα 100 σύμβολα.

Η πρόσβαση στο αρχείο sourcePath’ αρνείται.

Το καθορισμένο sourcePath’, όνομα αρχείου, ή και τα δύο υπερβαίνουν το μέγιστο μήκος που καθορίζεται από το σύστημα. Για παράδειγμα, σε πλατφόρμες με βάση τα Windows, τα μονοπάτια πρέπει να είναι λιγότερα από 248 χαρακτήρες, και τα ονόματα αρχείων πρέπει να είναι λιγότερα από 260 χαρακτήρες. - ή - name’ είναι πολύ μακρύ για xar.

NotSupportedException

Το αρχείο στο sourcePath’ περιέχει μια στήλη (:) στη μέση της γραμμής.

Δεν είναι δυνατόν να τροποποιηθεί το αρχείο.

`CreateEntry(Σύνδεση, Σύνδεση, XarCompressionSettings)`

Δημιουργήστε μια ενιαία είσοδο στο αρχείο.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Το όνομα της είσοδος.

source Stream

Η ροή εισόδου για την είσοδο.

compressionSettings XarCompressionSettings

Οι ρυθμίσεις συμπίεσης που χρησιμοποιούνται για την προσθήκη στοιχείου Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Εισαγωγική ένταξη.

`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.

Δεν είναι δυνατόν να τροποποιηθεί το αρχείο.

`DeleteEntry(XarEntry)`

Απομακρύνει την πρώτη εμφάνιση μιας συγκεκριμένης εισόδου από τη λίστα εισόδου.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Η είσοδος να αφαιρεθεί από τη λίστα εισόδου.

`Returns`

XarArchive

Εισαγωγική ένταξη.

`Examples`

Εδώ είναι πώς μπορείτε να αφαιρέσετε όλες τις εγγραφές εκτός από την τελευταία:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

`Dispose()`

Εκτελεί καθορισμένα από την εφαρμογή καθήκοντα που σχετίζονται με την απελευθέρωση, την απελευθέρωση ή την ανακατασκευή μη διαχειριζόμενων πόρων.

public void Dispose()

`Dispose(Μπόλ)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Πρέπει να αφαιρεθούν οι διαχειριζόμενοι πόροι.

`ExtractToDirectory(Σύνδεσμος)`

Απομακρύνει όλα τα αρχεία στο αρχείο στο δελτίο που παρέχεται.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Η διαδρομή προς το δελτίο για να τοποθετήσετε τα εξαγόμενα αρχεία.

`Examples`

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Εάν το κατάλογο δεν υπάρχει, θα δημιουργηθεί.

`Exceptions`

Ο δρόμος είναι μηδέν

Ο κάτοχος δεν έχει την απαιτούμενη άδεια πρόσβασης στο υπάρχον κατάλογο.

NotSupportedException

Εάν η διεύθυνση δεν υπάρχει, το μονοπάτι περιέχει έναν χαρακτήρα στήλης (:) που δεν είναι μέρος μιας ετικέτας οδήγησης (“C:”).

Ο δρόμος είναι μια γραμμή μηδενικού μήκους, περιέχει μόνο λευκό χώρο, ή περιέχει έναν ή περισσότερους αναλλοίωτους χαρακτήρες. Μπορείτε να ζητήσετε αναλλοίωτους χαρακτήρες χρησιμοποιώντας τη μέθοδο System.IO.Path.GetInvalidPathChars. -ή- ο δρόμος είναι προκαθορισμένος με, ή περιέχει, μόνο έναν χαρακτήρα του εντέρου (:).

Ο κατάλογος που καθορίζεται από το μονοπάτι είναι ένα αρχείο. -ή- Το όνομα δικτύου δεν είναι γνωστό.

InvalidDataException

Το αρχείο είναι διαφθαρμένο.

`Save(Σύνδεσμος, XarSaveOptions)`

Αποθηκεύει τα αρχεία στο αρχείο προορισμού που παρέχεται.

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

`Parameters`

destinationFileName string

Ο δρόμος του αρχείου για να δημιουργηθεί.Εάν το καθορισμένο όνομα αρχείου υποδεικνύει ένα υπάρχον αρχείο, θα υπεργραφεί.

saveOptions XarSaveOptions

Επιλογές για να αποθηκεύσετε το αρχείο xar με.

`Exceptions`

destinationFileName’ is null.

Δεν είναι δυνατόν να τροποποιηθεί το αρχείο.

`Save(Δραστηριότητες, XarSaveOptions)`

Αποθηκεύστε τα αρχεία στο παρεχόμενο ρεύμα.

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

Ο προορισμός ρεύματος.

saveOptions XarSaveOptions

Επιλογές για να αποθηκεύσετε το αρχείο xar με.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.