Class ZstandardArchive

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

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

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

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

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

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(Μπόλ)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Extract(Stream)`

Εξάγετε το αρχείο στο δίκτυο που παρέχεται.

public void Extract(Stream destination)

`Parameters`

destination Stream

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

`Examples`

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

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

Εξάγετε το αρχείο στο αρχείο με τη διαδρομή.

public FileInfo Extract(string path)

`Parameters`

path string

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

`Returns`

FileInfo

Πληροφορίες για ένα αποσπασμένο αρχείο.

`Exceptions`

path’ is null.

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

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

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

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

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

Εξάγει το περιεχόμενο του αρχείου στο δελτίο που παρέχεται.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

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

`Remarks`

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

`Exceptions`

destinationDirectory’ is null.

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

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

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

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

`Open()`

Ανοίγει το αρχείο για εξόρυξη και παρέχει μια ροή με περιεχόμενο αρχείων.

public Stream Open()

`Returns`

Stream

Η ροή που αντιπροσωπεύει το περιεχόμενο του αρχείου.

`Examples`

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

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Μπορείτε να χρησιμοποιήσετε τη μέθοδο Stream.CopyTo για το .NET 4.0 και υψηλότερο: unpacked.KopyTo(εξαιρεθεί);

`Remarks`

Διαβάστε από το ρεύμα για να πάρετε το αρχικό περιεχόμενο ενός αρχείου.

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

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

`Parameters`

outputStream Stream

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

settings ZstandardSaveOptions

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

`Examples`

Γράψτε συμπιεσμένα δεδομένα στην ροή απάντησης http.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

`Remarks`

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

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Η πηγή δεν έχει παραδοθεί.

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

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

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

`Parameters`

destinationFileName string

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

settings ZstandardSaveOptions

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

`Examples`

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

`Exceptions`

destinationFileName’ is null.

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

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

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

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

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

`Save(FileInfo και ZstandardSaveOptions)`

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

`Parameters`

destination FileInfo

FileInfo, το οποίο θα ανοίξει ως ροή προορισμού.

settings ZstandardSaveOptions

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

`Examples`

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.zst"));
}

`Exceptions`

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

Η διαδρομή του αρχείου είναι κενή ή περιέχει μόνο λευκούς χώρους.

FileNotFoundException

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

Η διαδρομή προς το αρχείο είναι μόνο ανάγνωση ή είναι μια διεύθυνση.

DirectoryNotFoundException

destination’ is null.

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

IOException

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

`SetSource(Stream)`

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

public void SetSource(Stream source)

`Parameters`

source Stream

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

`Examples`

using (var archive = new ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

`SetSource(FileInfo)`

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

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Η αναφορά σε ένα αρχείο που πρέπει να συμπιέζεται.

`Examples`

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.zst");
}

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

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

public void SetSource(string path)

`Parameters`

path string

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

`Examples`

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

`Exceptions`

path’ is null.

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

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

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