Class SharArchive

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

UnauthorizedAccessException

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

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

DirectoryNotFoundException

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

NotSupportedException

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

FileNotFoundException

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

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

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

`Properties`

`Entries`

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

public ReadOnlyCollection<sharentry> Entries { get; }

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

ReadOnlyCollection &lt · SharEntry >

`Methods`

`CreateEntries(Στέλινγκ, Μπόλ)`

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

public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

`Parameters`

sourceDirectory string

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

includeRootDirectory bool

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

`Returns`

Εισαγωγική ένταξη του Σαρ.

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

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

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

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

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

`CreateEntries(Ενημέρωση, Bool)`

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

public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

`Parameters`

directory DirectoryInfo

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

includeRootDirectory bool

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

`Returns`

Εισαγωγική ένταξη του Σαρ.

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

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

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

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

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

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`Parameters`

name string

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

fileInfo FileInfo

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

openImmediately bool

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

`Returns`

SharEntry

Εισαγωγική ένταξη του Σαρ.

`Examples`

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

`Remarks`

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

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

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

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

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

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

sourcePath string

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

openImmediately bool

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

`Returns`

SharEntry

Εισαγωγική ένταξη του Σαρ.

`Examples`

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

`Remarks`

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

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

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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

NotSupportedException

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

`CreateEntry(Σύνδεσμος, Stream)`

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

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

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

source Stream

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

`Returns`

SharEntry

Εισαγωγική ένταξη του Σαρ.

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

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

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

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

`Returns`

Εισαγωγική ένταξη του Σαρ.

`Examples`

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

using (var archive = new SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(ΕΝΤ)`

Απομακρύνετε την εισαγωγή από τη λίστα εισαγωγών με δείκτη.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Ο μηδενικός δείκτης εισόδου που πρέπει να αφαιρεθεί.

`Returns`

ArgumentOutOfRangeException

Το αρχείο με την είσοδο διαγράφεται.

`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(Μπόλ)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Dispose()`

public void Dispose()

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

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

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

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

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

`Remarks`

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

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

DirectoryNotFoundException

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

Το καθορισμένο destinationFileName’ είναι αναποτελεσματικό (για παράδειγμα, είναι σε μια μη χαρτογράφιση δίσκου).

UnauthorizedAccessException

Ένα σφάλμα I/O εμφανίστηκε κατά το άνοιγμα του αρχείου.

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.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

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

`Save(Stream)`

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

public void Save(Stream output)

`Parameters`

output Stream

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

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

Πρέπει να είναι γραπτή.

`Exceptions`

output’ is null.