TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

Δημιουργία μίας καταχώρησης μέσα στο αρχείο.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ΠαράμετροςΤύποςΠεριγραφή
nameStringΤο όνομα της καταχώρισης.
sourceStreamΗ ροή εισόδου για την καταχώρηση.
fileInfoFileSystemInfoΤα μεταδεδομένα του αρχείου ή του φακέλου που πρόκειται να συμπιεστούν.

Επιστρεφόμενη Αξία

Περίπτωση εισαγωγής πίσσας.

Εξαιρέσεις

εξαίρεσηκατάσταση
PathTooLongExceptionname είναι πολύ μεγάλη για την πίσσα από το πρότυπο IEEE 1003.1-1998.
ArgumentExceptionΌνομα αρχείου, ως μέρος τουname, υπερβαίνει τα 100 σύμβολα.

Παρατηρήσεις

Το όνομα καταχώρισης ορίζεται αποκλειστικά μέσαname παράμετρος. Το όνομα αρχείου που παρέχεταιfileInfo η παράμετρος δεν επηρεάζει το όνομα της καταχώρισης.

fileInfo μπορεί να αναφέρεται σεDirectoryInfo εάν η καταχώρηση είναι κατάλογος.

Παραδείγματα

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Δείτε επίσης

CreateEntry(string, FileInfo, bool)

Δημιουργία μίας καταχώρησης μέσα στο αρχείο.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ΠαράμετροςΤύποςΠεριγραφή
nameStringΤο όνομα της καταχώρισης.
fileInfoFileInfoΤα μεταδεδομένα του αρχείου ή του φακέλου που πρόκειται να συμπιεστούν.
openImmediatelyBooleanΣωστό εάν ανοίξετε το αρχείο αμέσως, διαφορετικά ανοίξτε το αρχείο κατά την αποθήκευση αρχειοθέτησης.

Επιστρεφόμενη Αξία

Περίπτωση εισαγωγής πίσσας.

Εξαιρέσεις

εξαίρεσηκατάσταση
PathTooLongExceptionname είναι πολύ μεγάλη για την πίσσα από το πρότυπο IEEE 1003.1-1998.
ArgumentExceptionΌνομα αρχείου, ως μέρος τουname, υπερβαίνει τα 100 σύμβολα.

Παρατηρήσεις

Το όνομα καταχώρισης ορίζεται αποκλειστικά μέσαname παράμετρος. Το όνομα αρχείου που παρέχεταιfileInfo η παράμετρος δεν επηρεάζει το όνομα της καταχώρισης.

fileInfo μπορεί να αναφέρεται σεDirectoryInfo εάν η καταχώρηση είναι κατάλογος.

Εάν το αρχείο ανοίξει αμέσως μεopenImmediatelyη παράμετρος αποκλείεται μέχρι να διατεθεί το αρχείο.

Παραδείγματα

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Δείτε επίσης

CreateEntry(string, string, bool)

Δημιουργία μίας καταχώρησης μέσα στο αρχείο.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ΠαράμετροςΤύποςΠεριγραφή
nameStringΤο όνομα της καταχώρισης.
pathStringΔιαδρομή προς το αρχείο που θα συμπιεστεί.
openImmediatelyBooleanΣωστό εάν ανοίξετε το αρχείο αμέσως, διαφορετικά ανοίξτε το αρχείο κατά την αποθήκευση αρχειοθέτησης.

Επιστρεφόμενη Αξία

Περίπτωση εισαγωγής πίσσας.

Εξαιρέσεις

εξαίρεσηκατάσταση
ArgumentNullExceptionpath είναι μηδενικό.
SecurityExceptionΟ καλών δεν έχει την απαιτούμενη άδεια πρόσβασης.
ArgumentExceptionοpath είναι κενό, περιέχει μόνο λευκά κενά ή περιέχει μη έγκυρους χαρακτήρες. - ή - Όνομα αρχείου, ως μέρος τουname, υπερβαίνει τα 100 σύμβολα.
UnauthorizedAccessExceptionΠρόσβαση στο αρχείοpath απορρίπτεται.
PathTooLongExceptionΤο καθορισμένοpath , όνομα αρχείου ή και τα δύο υπερβαίνουν το μέγιστο μήκος που καθορίζεται από το σύστημα. Για παράδειγμα, σε πλατφόρμες που βασίζονται σε Windows, οι διαδρομές πρέπει να είναι μικρότερες από 248 χαρακτήρες και τα ονόματα αρχείων πρέπει να είναι λιγότερο από 260 χαρακτήρες. - ή -name είναι πολύ μεγάλη για την πίσσα από το πρότυπο IEEE 1003.1-1998.
NotSupportedExceptionΑρχείο στοpath περιέχει άνω και κάτω τελεία (:) στη μέση της συμβολοσειράς.

Παρατηρήσεις

Το όνομα καταχώρισης ορίζεται αποκλειστικά μέσαname παράμετρος. Το όνομα αρχείου που παρέχεταιpath η παράμετρος δεν επηρεάζει το όνομα της καταχώρισης.

Εάν το αρχείο ανοίξει αμέσως μεopenImmediatelyη παράμετρος αποκλείεται μέχρι να διατεθεί το αρχείο.

Παραδείγματα

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

Δείτε επίσης

TarArchive.CreateEntries TarArchive.DeleteEntry